inet_net_pton()¶

The inet_net_pton() function converts pres, a null-terminated string containing an Internet network number in presentation format to network format. The result of the conversion, which is in network byte order, is placed in the buffer pointed to by netp. (The netp argument typically points to an in_addr structure.) The nsize argument specifies the number of bytes available in netp.

При успешном выполнении inet_net_pton() возвращает количество бит в поле номера сети результата, помещённого в netp. Обсуждение входного представленческого формата и возвращаемое значение смотрите в ЗАМЕЧАНИЯХ.

Замечание: буфер, указанный в netp, должен быть заполнен нулями до вызова inet_net_pton(), так как вызов изменяет только байты, необходимые для номера сети (или сколько явно указано в pres), что может быть меньше, чем байт в полном адресе сети.

inet_net_ntop()¶

Функция inet_net_ntop() преобразует номер сети в буфере, указанном в netp, в представленческий формат; значение *netp рассматривается в сетевом порядке байт. В аргументе bits задаётся количество бит в номере сети из *netp.

Строка в представленческом формате с null в конце помещается в буфер, на который указывает pres. В аргументе psize задаётся количество байт, доступных в pres. Представленческая строка имеет формат CIDR: адрес сети в виде чисел, разделённых точками, затем косая черта и размер сети в битах.

Представленческий формат входных данных inet_net_pton()¶

Номер сети может задаваться в виде шестнадцатеричного значения или в точечно-десятичной форме.

Шестнадцатеричное значение определяется по начальному «0x» или «0X». Шестнадцатеричные цифры заполняют полубайты (половина октета) номера сети слева направо в сетевом порядке байт.

В точечно-десятичной форме указываются, максимум, первые четыре октета, с помощью десятичных чисел и точек. То есть можно использовать следующие форматы:

a.b.c.d
a.b.c
a.b
a

Каждая часть — это число от 0 до 255, которое заполняет один байт получаемого номера сети; заполнение производится слева направо, в сетевом порядке байт (от старшего к младшему). Если часть пропущена, то байт результата в номере сети равно нулю.

В шестнадцатеричном или точечно-десятичном формате номер сети может содержать косую черту и число от 0 до 32, которое задаёт размер сети в битах.

Возвращаемое значение inet_net_pton()¶

Возвращаемым значением inet_net_pton() является количество бит поля номера сети. Если входная строка представленческих данных заканчивается косой чертой и явным значением размера, то это значение является результатом inet_net_pton(). В противном случае возвращаемое значение, bits, определяется следующим образом:

• Если наиболее значимый байт номер сети больше или равен 240, то bits равно 32.
• Или же, если наиболее значимый байт номер сети больше или равен 224, то bits равно 4.
• Или же, если наиболее значимый байт номер сети больше или равен 192, то bits равно 24.
• Или же, если наиболее значимый байт номер сети больше или равен 128, то bits равно 16.
• В противном случае bits равно 8.

Если значение результата bits после определения больше или равно 8, но количество октетов, указанных в номере сети, превышает bits/8, то bits присваивается 8 кратное количество октетов, указанных на самом деле.

Исходный код программы¶

/* Компоновать с «-lresolv» */
#include <arpa/inet.h>
#include <stdio.h>
#include <stdlib.h>
#define errExit(msg)    do { perror(msg); exit(EXIT_FAILURE); \


                        } while (0)
int
main(int argc, char *argv[])
{


    char buf[100];


    struct in_addr addr;


    int bits;


    if (argc < 2) {


        fprintf(stderr,


                "Использование: %s представленческая-форма \


                                   [начальное-значение-адреса]\n",


                argv[0]);


        exit(EXIT_FAILURE);


    }


    /* Если указан argv[2] (число), то использовать его для инициализации


       буфера результата, передаваемого inet_net_pton() для того, чтобы


       мы могли увидеть, что inet_net_pton() инициализирует только те


       байты, которые нужны для номера сети. Если argv[2] не указан, то


       буфер инициализируется нулями (как рекомендуется). */


    addr.s_addr = (argc > 2) ? strtod(argv[2], NULL) : 0;


    /* Convert presentation network number in argv[1] to binary. */


    bits = inet_net_pton(AF_INET, argv[1], &addr, sizeof(addr));


    if (bits == -1)


        errExit("inet_net_ntop");


    printf("inet_net_pton() вернула: %d\n", bits);


    /* Convert binary format back to presentation, using 'bits'


       returned by inet_net_pton(). */


    if (inet_net_ntop(AF_INET, &addr, bits, buf, sizeof(buf)) == NULL)


        errExit("inet_net_ntop");


    printf("inet_net_ntop() выдала:  %s\n", buf);


    /* Показать «addr» в необработанном виде (в сетевом порядке байт)


       для того, чтобы мы могли увидеть байты, не отображаемые


       inet_net_ntop(); некоторые из этих байт могут быть не изменены


       inet_net_ntop(), и поэтому будут содержать любое начальное


       значение, которое было задано в argv[2]. */


    printf("Необработанный адрес:            %x\n", htonl(addr.s_addr));


    exit(EXIT_SUCCESS);
}