zmq_msg_init_size(3)

1ZMQ_MSG_INIT_SIZE(3)              0MQ Manual              ZMQ_MSG_INIT_SIZE(3)
2
3
4

NAME

6       zmq_msg_init_size - initialise 0MQ message of a specified size
7

SYNOPSIS

9       int zmq_msg_init_size (zmq_msg_t *msg, size_t size);
10

DESCRIPTION

12       The zmq_msg_init_size() function shall allocate any resources required
13       to store a message size bytes long and initialise the message object
14       referenced by msg to represent the newly allocated message.
15
16       The implementation shall choose whether to store message content on the
17       stack (small messages) or on the heap (large messages). For performance
18       reasons zmq_msg_init_size() shall not clear the message data.
19
20           Caution
21           Never access zmq_msg_t members directly, instead always use the
22           zmq_msg family of functions.
23
24           Caution
25           The functions zmq_msg_init(), zmq_msg_init_data() and
26           zmq_msg_init_size() are mutually exclusive. Never initialize the
27           same zmq_msg_t twice.
28

RETURN VALUE

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

ERRORS

35       ENOMEM
36           Insufficient storage space is available.
37

AUTHORS

43       This 0MQ manual page was written by Martin Sustrik
44       <sustrik@250bpm.com[1]> and Martin Lucina <mato@kotelna.sk[2]>.
45

NOTES

47        1. sustrik@250bpm.com
48           mailto:sustrik@250bpm.com
49
50        2. mato@kotelna.sk
51           mailto:mato@kotelna.sk
52
53
54
550MQ 2.1.4                         03/30/2011              ZMQ_MSG_INIT_SIZE(3)