zmq_msg_init_data - 从一个指定的存储空间中初始化一个ZMQ消息对象的数据
Synopsis
typedef void (zmq_free_fn) (void *data, void *hint);
int zmq_msg_init_data (zmq_msg_t *msg, void *data, size_t size, zmq_free_fn *ffn,
void *hint);
Description
zmq_msg_init_data()函数会用data参数和size参数指定的数据对msg参数指定的ZMQ消息对象的内容进行初始化。ZMQ不会执行拷贝操作,并且ZMQ会取得指定数据的拥有权。
如果提供了回收功能函数ffn,ffn将会在data数据不再使用的时候被ZMQ调用一次,ZMQ会将zmq_msg_init_data()函数中的参数data和hint参数传递给ffn函数。
永远不要直接对zmq_msg_t对象进行直接操作,而是要使用zmq_msg函数族进行操作。
zmq_msg_init()、zmq_msg_init_data()和zmq_msg_init_size()这三个函数是互斥的。永远不要把一个zmq_msg_t对象初始化两次。
Return value
函数zmq_msg_init_data()执行成功会返回0。否则返回 -1,并且设置errno的值为下列指定的值。
Errors
ENOMEM
存储空间不足。
Example
使用一个指定的存储空间对ZMQ消息对象进行初始化。
void my_free (void *data, void *hint)
{
free (data);
}
/* ... */
void *data = malloc (6);
assert (data);
memcpy (data, "ABCDEF", 6);
zmq_msg_t msg;
rc = zmq_msg_init_data (&msg, data, 6, my_free, NULL); assert (rc == 0);
本文转自郝峰波博客园博客,原文链接:http://www.cnblogs.com/fengbohello/p/4245656.html,如需转载请自行联系原作者