socket.getaddrinfo ()
socket.getaddrinfo ( host, port, family=0, type=0, proto=0, flags=0 )
Преобразует аргументы host/port в последовательность из кортежа с 5 членами, которые содержат все необходимые аргументы для создания сокета, подключенного к этой службе. host - это доменное имя, строковое представление адреса IPv4/v6 или None
. port - это строковое имя службы, такое как 'http'
, числовой номер порта или None
. Передав None
в качестве значения host и port, вы можете передать NULL
в базовый API C.
Аргументы семейства family, типа type и прототипа proto могут быть дополнительно указаны, чтобы сузить список возвращаемых адресов. Передача нуля в качестве значения для каждого из этих аргументов выбирает полный диапазон результатов. Аргумент flags может быть одной или несколькими константами AI_*
и будет влиять на способ вычисления и возврата результатов. Например, AI_NUMERICHOST
отключит разрешение доменного имени и вызовет ошибку, если host является доменным именем.
Функция возвращает список из кортежа с 5 элементами со следующей структурой:
(family, type, proto, canonname, sockaddr)
В этих кортежах family, type, proto являются целыми числами и предназначены для передачи в функцию socket (). canonname будет строкой, представляющей каноническое имя хоста host, если AI_CANONNAME
является частью аргумента flags; иначе canonname будет пустым. sockaddr - это кортеж, описывающий адрес сокета, формат которого зависит от возвращаемого семейства family (кортеж с 2 элементами (address, port)
для AF_INET, кортеж с 4 элементами (address, port, flowinfo, scope_id)
для AF_INET6) и предназначен для передачи в метод socket.connect ().
Вызывает событие аудита socket.getaddrinfo
с аргументами host, port, family, type, protocol.
В следующем примере извлекается адресная информация для гипотетического TCP-соединения с example.org
через порт 80 (результаты могут отличаться в вашей системе, если IPv6 не включен):
Изменено в версии 3.2: параметры теперь можно передавать с помощью ключевых аргументов.
Изменено в версии 3.7: для адресов многоадресной рассылки IPv6 строка, представляющая адрес, не будет содержать %scope_id
часть.
Last updated