js8call/JS8_Network/NetworkServerLookup.h
2026-01-18 19:19:15 -06:00

38 lines
1.3 KiB
C++

#ifndef NETWORK_SERVER_LOOKUP_HPP__
#define NETWORK_SERVER_LOOKUP_HPP__
#include <QAbstractSocket>
#include <QHostAddress>
#include <tuple>
class QString;
//
// Do a blocking DNS lookup using query as a destination host address
// and port.
//
// query can be one of:
//
// 1) "" (empty string) - use defaults
// 2) ":nnnnn" - override default service port with port nnnnn
// 3) "<valid-host-name>" - override default host address with DNS lookup
// 4) "nnn.nnn.nnn.nnn" - override default host address with the IPv4 address
// given by nnn.nnn.nnn.nnn 5) "[<valid-IPv6-address]" - override default host
// address with the given IPv6 address 6) "<valid-host-name>:nnnnn" - use as per
// (3) & (2) 7) "nnn.nnn.nnn.nnn:nnnnn" - use as per (4) & (2) 8)
// "[<valid-IPv6-address]:nnnnn" - use as per (5) & (2)
//
// The first host address matching the protocol and the service port
// number are returned.
//
// If no suitable host address is found QHostAddress::Null will be
// returned in the first member of the result tuple.
//
std::tuple<QHostAddress, quint16> network_server_lookup(
QString query, quint16 default_service_port,
QHostAddress default_host_address = QHostAddress::LocalHost,
QAbstractSocket::NetworkLayerProtocol protocol =
QAbstractSocket::AnyIPProtocol);
#endif