NAME

       ixp_pstrings

SYNOPSIS

       #include <ixp.h>

       void ixp_pstrings(IxpMsg *msg, uint16_t *num, char *strings[], uint max);

DESCRIPTION

       Packs  or unpacks an array of UTF-8 encoded strings. The packed representation consists of
       a 16-bit element count followed by an array of strings as packed  by  ixp_pstring(3).  The
       unpacked representation is an array of nul-terminated character arrays.

       If  msg->mode  is MsgPack, *num strings in the array pointed to by strings are packed into
       the buffer at msg->pos. If msg->mode is MsgUnpack, *num  is  loaded  with  the  number  of
       strings  unpacked,  the array at *strings is loaded with pointers to the unpacked strings,
       and (*strings)[0] must be freed by the user. In either case, msg->pos is advanced  by  the
       number  of  bytes  read  or written. If the action would advance msg->pos beyond msg->end,
       msg->pos is still advanced, but no other action is taken. If *num  is  greater  than  max,
       msg->pos is set beyond msg->end and no other action is taken.

SEE ALSO

       IxpMsg, ixp_pstring, ixp_pdata