mirror of
https://github.com/zeromq/libzmq.git
synced 2024-12-13 18:55:10 +01:00
44 lines
1.1 KiB
Groff
44 lines
1.1 KiB
Groff
.TH zmq_msg_copy 3 "" "(c)2007-2009 FastMQ Inc." "0MQ User Manuals"
|
|
.SH NAME
|
|
zmq_msg_copy \- copies content of a message to another message
|
|
.SH SYNOPSIS
|
|
.B int zmq_msg_copy (zmq_msg_t *dest, zmq_msg_t *src);
|
|
.SH DESCRIPTION
|
|
Copy the
|
|
.IR src
|
|
message to
|
|
.IR dest .
|
|
The original content of
|
|
.IR dest
|
|
is orderly deallocated.
|
|
Caution: The implementation may choose not to physically copy the data, rather
|
|
to share the buffer between two messages. Thus avoid modifying message data
|
|
after the message was copied. Doing so can modify multiple message instances.
|
|
If what you need is actual hard copy, allocate new message using
|
|
.IR zmq_msg_size
|
|
and copy the data using
|
|
.IR memcpy .
|
|
.SH RETURN VALUE
|
|
In case of success the function returns zero. Otherwise it returns -1 and
|
|
sets
|
|
.IR errno
|
|
to the appropriate value.
|
|
.SH ERRORS
|
|
No errors are defined.
|
|
.SH EXAMPLE
|
|
.nf
|
|
zmq_msg_t dest;
|
|
rc = zmq_msg_init (&dest);
|
|
assert (rc == 0);
|
|
rc = zmq_msg_copy (&dest, &src);
|
|
assert (rc == 0);
|
|
.fi
|
|
.SH SEE ALSO
|
|
.BR zmq_msg_move (3)
|
|
.BR zmq_msg_init (3)
|
|
.BR zmq_msg_init_size (3)
|
|
.BR zmq_msg_init_data (3)
|
|
.BR zmq_msg_close (3)
|
|
.SH AUTHOR
|
|
Martin Sustrik <sustrik at 250bpm dot com>
|