名称

zmq_msg_init_size - 初始化指定大小的 0MQ 消息

概要

int zmq_msg_init_size (zmq_msg_t '*msg', size_t 'size');

描述

zmq_msg_init_size() 函数应分配存储长度为 'size' 字节的消息所需的任何资源，并初始化 'msg' 引用的消息对象以表示新分配的消息。

实现应选择将消息内容存储在栈上（小型消息）还是堆上（大型消息）。出于性能考虑，zmq_msg_init_size() 不应清除消息数据。

注意
 切勿直接访问 'zmq_msg_t' 的成员，而应始终使用 zmq_msg 系列函数。
注意
 函数 zmq_msg_init()、zmq_msg_init_data()、zmq_msg_init_size() 和 zmq_msg_init_buffer() 是互斥的。切勿对同一个 'zmq_msg_t' 进行两次初始化。

返回值

zmq_msg_init_size() 函数成功时应返回零。否则应返回 -1 并将 'errno' 设置为以下定义的值之一。

错误

ENOMEM

没有足够的存储空间可用。

另请参阅

作者

此页面由 0MQ 社区编写。如需更改，请阅读 0MQ 贡献政策，地址为 https://zeromq.cn/how-to-contribute/。