inet_ntop() - IP アドレス形式の 2 進数からテキストへの変換

標準

形式

#define _OPEN_SYS_SOCK_IPV6
#include <arpa/inet.h>

const char *inet_ntop(int af, const void *src, char *dst, socklen_t size);

#define _POSIX_C_SOURCE 200112L
#include <arpa/inet.h>

const char *inet_ntop(int af, const void *__restrict__ src, 
                       char * __restrict__ dst, socklen_t size);

機能説明

inet_ntop() 関数は、src で指定された、バイナリー形式の IP アドレスを、標準テキスト形式に変換し、その結果を dst に入れます。ただし、dst 内の使用可能スペース size が十分にあることが前提になります。引数 af は、IP アドレスのファミリーを指定します。これは、AF_INET または AF_INET6 が可能です。

引数 src は、af 引数が AF_INET の場合は、IPv4 インターネット・アドレス、af 引数が AF_INET6 の場合は、IPv6 インターネット・アドレスが入ったバッファーを指します。アドレスはネットワーク・バイト・オーダーでなければなりません。

引数 dst は、この関数が結果のテキスト・ストリングを保管するバッファーを指します。size 引数は、このバッファーのサイズを指定します。アプリケーションは、非 NULL の dst 引数を指定する必要があります。IPv6 アドレスの場合、バッファーは 46 バイト以上が必要です。IPv4 アドレスの場合、バッファーは 16 バイト以上が必要です。

#define INET_ADDRSTRLEN 16
#define INET6_ADDRSTRLEN 46

戻り値

正常に実行された場合、inet_ntop() は、変換されたアドレスを含むバッファーへのポインターを戻します。

関連情報

• arpa/inet.h
• netinet/in.h
• sys/socket.h
• inet_addr() - ネットワーク・バイト・オーダーへの IP アドレスの変換
• inet_makeaddr() - インターネット・ホスト・アドレスの作成
• inet_netof() - インターネット・ホスト・アドレスからのネットワーク番号の取得
• inet_network() - 10 進ホスト・アドレスからのネットワーク番号の取得
• inet_ntoa() - 10 進インターネット・ホスト・アドレスの取得
• inet_pton() - IP アドレス形式のテキストから 2 進数への変換