fmt_ip6_flat man page

fmt_ip6_flat — write a formatted ASCII representation of an IPv6 number

Syntax

#include <ip6.h>

unsigned int fmt_ip6_flat(char *dest,const char ip[16]);

Description

fmt_ip6_flat formats an IPv6 number in a flat ASCII representation from ip and writes the result into dest. It returns the number of bytes written (always 32).

This representation does not contain colons and is meant to be easily machine-readable. Use fmt_ip6 for the normal (standard) representation. This function is meant for places which use colons to separate fields and thus have problems interpreting the standard IPv6 notation.

If dest equals FMT_LEN (i.e. is zero), fmt_ip6_flat returns the number of bytes it would have written.

fmt_ip6_flat does not append \0.

For convenience, ip6.h defines the integer IP6_FMT to be big enough to contain every possible fmt_ip6_flat output plus \0.

Example

#include <ip6.h>

char buf[IP6_FMT];
char ip[16];
buf[fmt_ip6_flat(buf,ip)]=0;

See Also

scan_ip6_flat(3), fmt_ip6(3)

Referenced By

scan_ip6_flat(3).