summaryrefslogtreecommitdiff
path: root/doc/zmq_msg_more.txt
diff options
context:
space:
mode:
Diffstat (limited to 'doc/zmq_msg_more.txt')
-rw-r--r--doc/zmq_msg_more.txt63
1 files changed, 63 insertions, 0 deletions
diff --git a/doc/zmq_msg_more.txt b/doc/zmq_msg_more.txt
new file mode 100644
index 0000000..7836872
--- /dev/null
+++ b/doc/zmq_msg_more.txt
@@ -0,0 +1,63 @@
+zmq_msg_more(3)
+===============
+
+
+NAME
+----
+zmq_msg_more - indicate if there are more message parts to receive
+
+
+SYNOPSIS
+--------
+*int zmq_msg_more (zmq_msg_t '*message');*
+
+
+DESCRIPTION
+-----------
+The _zmq_msg_more()_ function indicates whether this is part of a multi-part
+message, and there are further parts to receive.
+
+
+RETURN VALUE
+------------
+The _zmq_msg_more()_ function shall return zero if this is the final part of
+a multi-part message, or the only part of a single-part message. It shall
+return 1 if there are further parts to receive.
+
+
+EXAMPLE
+-------
+.Receiving a multi-part message
+----
+zmq_msg_t part;
+while (true) {
+ // Create an empty 0MQ message to hold the message part
+ int rc = zmq_msg_init (&part);
+ assert (rc == 0);
+ // Block until a message is available to be received from socket
+ rc = zmq_recvmsg (socket, &part, 0);
+ assert (rc != -1);
+ if (zmq_msg_more (&part))
+ fprintf (stderr, "more\n");
+ else {
+ fprintf (stderr, "end\n");
+ break;
+ }
+ zmq_msg_close (part);
+}
+----
+
+
+SEE ALSO
+--------
+linkzmq:zmq_msg_get[3]
+linkzmq:zmq_msg_set[3]
+linkzmq:zmq_msg_init[3]
+linkzmq:zmq_msg_close[3]
+linkzmq:zmq[7]
+
+
+AUTHORS
+-------
+This 0MQ manual page was written by Chuck Remes <cremes@mac.com> and Pieter
+Hintjens <ph@imatix.com>.