/* $Id: ipv4_format.c 710 2006-07-27 19:02:06Z bruce $ */
#include "ipv4.h"

static char* format_part(unsigned char i, char* str)
{
  if (i >= 10) {
    str = format_part(i / 10, str);
    i = i % 10;
  }
  *str++ = i + '0';
  return str;
}

/** Produce a formatted C string from an IPv4 address.

\note The return value is statically allocated.  Multiple calls to this
function will return pointers to the same string.
*/
const char* ipv4_format(const ipv4addr* addr)
{
  static char buf[16];
  buf[fmt_ipv4addr(buf, addr)] = 0;
  return buf;
}

/** Produce a formatted string from an IPv4 address.

The given buffer must be at least 15 bytes long, or 16 bytes if it needs
to contain the standard trailing \c NUL byte.

\return The number of bytes written to the buffer.

\note This routine is thread and recursion safe.
*/
unsigned fmt_ipv4addr(char* buffer, const ipv4addr* addr)
{
  char* str = buffer;
  str = format_part(addr->addr[0], str); *str++ = '.';
  str = format_part(addr->addr[1], str); *str++ = '.';
  str = format_part(addr->addr[2], str); *str++ = '.';
  str = format_part(addr->addr[3], str);
  return str - buffer;
}

#ifdef SELFTEST_MAIN
#include "selftest.c"
void test(const ipv4addr* ip)
{
  char buffer[32];
  unsigned i;
  debugfn(i = fmt_ipv4addr(buffer, ip));
  buffer[i++] = '\n';
  buffer[i] = 0;
  obuf_putsflush(&outbuf, buffer);
}

MAIN
{
  ipv4addr ip = {{1,2,3,4}};
  test(&IPV4ADDR_ANY);
  test(&IPV4ADDR_BROADCAST);
  test(&IPV4ADDR_LOOPBACK);
  test(&ip);
}
#endif
#ifdef SELFTEST_EXP
result=7
0.0.0.0
result=15
255.255.255.255
result=9
127.0.0.1
result=7
1.2.3.4
#endif