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)