Данная функция преобразует структуру сетевого адреса
src
в строку символов с сетевым адресом (типа
af),
которая затем копируется в символьный буфер
dst;
размер этого буфера составляет
cnt
байтов.
Возможности функции
inet_ntop(3)
несколько шире, чем функции
inet_ntoa(3),
так как первая может поддерживать несколько типов адресов, и использование
inet_ntoa(3)
будет считаться устаревшим и ненужным (по сравнению с
inet_ntop(3)).
На текущий момент поддерживаются следующие типы адресов:
AF_INET
src
указывает на
struct in_addr
(в формате сетевого порядка расположения байтов),
которая преобразуется в IPv4-сетевой адрес в формате "ddd.ddd.ddd.ddd".
Буфер
dst
должен быть размером, по меньшей мере, равным
INET_ADDRSTRLEN
байтам.
AF_INET6
src
указывает на
struct in6_addr
(в формате сетевого порядка расположения байтов),
которая преобразуется в представление этого адреса в наиболее
верном формате IPv6. Буфер
dst
должен быть размером, по меньшей мере, равным
INET6_ADDRSTRLEN
байтам.
ВОЗВРАЩАЕМЫЕ ЗНАЧЕНИЯ
inet_ntop
возвращает ненулевой указатель на
dst.
В случае ошибок возвращается NULL, а также
errno
присваивается значение
EAFNOSUPPORT,
если значение
af
не было установлено равным корректному типу адреса
или равным
ENOSPC,
если полученная после преобразования строка превышает размер
dst
(заданный параметром
cnt).
