table of contents
fmt_ip6(3) | Library Functions Manual | fmt_ip6(3) |
NAME¶
fmt_ip6 - write a formatted ASCII representation of an IPv6 numberSYNTAX¶
#include <ip6.h>unsigned int fmt_ip6(char *dest,const char ip[16]);
DESCRIPTION¶
fmt_ip6 formats an IPv6 number in ASCII representation from ip and writes the result into dest. It returns the number of bytes written.fmt_ip6 will apply "::" compression to the output.
If ip is an IPv4-mapped IPv6 address, fmt_ip6 will output the last 4 bytes as IPv4 number in dotted-decimal notation.
If dest equals FMT_LEN (i.e. is zero), fmt_ip6 returns the number of bytes it would have written.
fmt_ip6 does not append \0.
For convenience, ip6.h defines the integer IP6_FMT to be big enough to contain every possible fmt_ip6 output plus \0.
EXAMPLE¶
#include <ip6.h>char buf[IP6_FMT]; char ip[16]; buf[fmt_ip6(buf,ip)]=0;