NAME

xs_msg_move - move content of a message to another message

SYNOPSIS

int xs_msg_move (xs_msg_t *dest, xs_msg_t *src);

DESCRIPTION

The xs_msg_move() function shall move the content of the message object referenced by src to the message object referenced by dest. No actual copying of message content is performed, dest is simply updated to reference the new content. src becomes an empty message after calling xs_msg_move(). The original content of dest, if any, shall be released.

Caution

Never access xs_msg_t members directly, instead always use the xs_msg family of functions.

RETURN VALUE

The xs_msg_move() function shall return zero if successful. Otherwise it shall return -1 and set errno to one of the values defined below.

ERRORS

EFAULT

Invalid message.

AUTHORS

The Crossroads documentation was written by Martin Sustrik <sustrik@250bpm.com[1]> and Martin Lucina <martin@lucina.net[2]>.

NOTES

1.: sustrik@250bpm.com

mailto:sustrik@250bpm.com

2.: martin@lucina.net

mailto:martin@lucina.net