IXP_PSTRING(3)

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)