inet_ntop
Section: C Library Functions (3)
Updated: 2025-06-28
Index
JM Home Page
roff page
名前
inet_ntop - IPv4/IPv6 アドレスをバイナリ形式からテキスト形式に変換する
ライブラリ
標準 C ライブラリ (libc,~-lc)
書式
#include <arpa/inet.h>
const char *inet_ntop(socklen_t size;
int af, const void *restrict src,
char dst[restrict size], socklen_t size);
説明
この関数は、 af アドレスファミリーのネットワークアドレス構造体 src を文字列に変換する。 変換結果の文字列は、 dst
が指すバッファーにコピーされる。 dst は NULL でないポインターでなければならない。 呼び出し時に、このバッファーで利用できるバイト数を
引数 size に指定する。
inet_ntop() は inet_ntoa(3) 関数を拡張して複数のアドレスファミリーを扱えるようにしたものである。 今後は
inet_ntoa(3) は使わず、 inet_ntop() を使うようにすると良いだろう。
現在サポートされているアドレスファミリーは以下の通り:
- AF_INET
-
src points to a struct in_addr (in network byte order) which is
converted to an IPv4 network address in the dotted-decimal format,
"ddd.ddd.ddd.ddd". The buffer dst must be at least
INET_ADDRSTRLEN bytes long.
- AF_INET6
-
この場合 src は (ネットワークバイトオーダーの) struct in6_addr へのポインターとみなされ、この構造体の内容が、
(このアドレスに対してもっとも適切な) IPv6 ネットワークアドレスの表示形式に変換される。 バッファー dst は少なくとも
INET6_ADDRSTRLEN バイトの長さを持たなければならない。
返り値
成功すると、 inet_ntop() は dst への (NULL でない) ポインターを返す。 エラーがあった場合は NULL を返し、
errno をエラーを示す値に適切に設定する。
エラー
- EAFNOSUPPORT
-
af がサポートされているアドレスファミリーでなかった。
- ENOSPC
-
変換されたアドレス文字列の長さが size で指定されたサイズを超過してしまう。
属性
この節で使用されている用語の説明は attributes(7) を参照のこと。
| Interface | Attribute | Value
|
|
inet_ntop()
| Thread safety | MT-Safe locale
|
標準規格
POSIX.1-2008.
歴史
POSIX.1-2001.
Note that RFC 2553 defines a prototype where the last argument size is
of type size_t. Many systems follow RFC 2553. glibc 2.0 and 2.1 have
size_t, but 2.2 and later have socklen_t.
バグ
AF_INET6 は IPv4 がマップされた IPv6 アドレスを IPv6 形式に変換してしまう。
例
inet_pton(3) を参照。
関連項目
getnameinfo(3), inet(3), inet_pton(3)
Index
- 名前
-
- ライブラリ
-
- 書式
-
- 説明
-
- 返り値
-
- エラー
-
- 属性
-
- 標準規格
-
- 歴史
-
- バグ
-
- 例
-
- 関連項目
-
This document was created by
man2html,
using the manual pages.