NAME

       ixp_pstring

SYNOPSIS

       #include <ixp.h>

       void ixp_pstring(IxpMsg *msg, char **s);

DESCRIPTION

       Packs  or  unpacks  a  UTF-8 encoded string. The packed representation of the string consists of a 16-bit
       unsigned integer followed by the contents of the string. The unpacked representation is a  nul-terminated
       character array.

       If  msg->mode  is MsgPack, the string pointed to by s is packed into the buffer at msg->pos. If msg->mode
       is MsgUnpack, the address  pointed  to  by  s  is  loaded  with  a  malloc(3)  allocated,  nul-terminated
       representation  of  the  string packed at msg->pos. 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.

SEE ALSO

       IxpMsg(3), ixp_pstrings(3), ixp_pdata(3)

libixp Manual                                       2012 Dec                                      IXP_PSTRING(3)