mirror of
https://github.com/zeromq/libzmq.git
synced 2024-12-28 07:58:14 +08:00
67e02ca8bc
contributors and doesn't reflect the real process. I've taken out all named authors and referred to the contribution policy. Hopefully this will improve the contributions to the man pages.
73 lines
1.5 KiB
Plaintext
73 lines
1.5 KiB
Plaintext
zmq_msg_get(3)
|
|
==============
|
|
|
|
|
|
NAME
|
|
----
|
|
zmq_msg_get - get message property
|
|
|
|
|
|
SYNOPSIS
|
|
--------
|
|
*int zmq_msg_get (zmq_msg_t '*message', int 'property');*
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
The _zmq_msg_get()_ function shall return the value for the property
|
|
specified by the 'property' argument for the message pointed to by the
|
|
'message' argument.
|
|
|
|
The following properties can be retrieved with the _zmq_msg_get()_ function:
|
|
|
|
*ZMQ_MORE*::
|
|
Indicates that there are more message frames to follow after the 'message'.
|
|
|
|
RETURN VALUE
|
|
------------
|
|
The _zmq_msg_get()_ function shall return the value for the property if
|
|
successful. Otherwise it shall return `-1` and set 'errno' to one of the
|
|
values defined below.
|
|
|
|
|
|
ERRORS
|
|
------
|
|
*EINVAL*::
|
|
The requested _property_ is unknown.
|
|
|
|
|
|
EXAMPLE
|
|
-------
|
|
.Receiving a multi-frame message
|
|
----
|
|
while (true) {
|
|
// Create an empty 0MQ message to hold the message frame
|
|
int rc = zmq_msg_init (&frame);
|
|
assert (rc == 0);
|
|
// Block until a message is available to be received from socket
|
|
rc = zmq_msg_recv (socket, &frame, 0);
|
|
assert (rc != -1);
|
|
if (zmq_msg_get (&frame, ZMQ_MORE))
|
|
fprintf (stderr, "more\n");
|
|
else {
|
|
fprintf (stderr, "end\n");
|
|
break;
|
|
}
|
|
zmq_msg_close (frame);
|
|
}
|
|
----
|
|
|
|
|
|
SEE ALSO
|
|
--------
|
|
linkzmq:zmq_msg_set[3]
|
|
linkzmq:zmq_msg_init[3]
|
|
linkzmq:zmq_msg_close[3]
|
|
linkzmq:zmq[7]
|
|
|
|
|
|
AUTHORS
|
|
-------
|
|
This page was written by the 0MQ community. To make a change please
|
|
read the 0MQ Contribution Policy at <http://www.zeromq.org/docs:contributing>.
|