This documentation is for the TIP (development tree) of NNG and may represent unreleased changes or functionality that is experimental, and is subject to change before release. The latest released version is v1.7.3. See the documentation for v1.7.3 for the most up-to-date information.

nng_msg_alloc(3)

NAME

nng_msg_alloc - allocate a message

SYNOPSIS

#include <nng/nng.h>

int nng_msg_alloc(nng_msg **msgp, size_t size);

DESCRIPTION

The nng_msg_alloc() function allocates a new message with body length size and stores the result in msgp. Messages allocated with this function contain a body and optionally a header. They are used with receive and transmit functions.

RETURN VALUES

This function returns 0 on success, and non-zero otherwise.

ERRORS

NNG_ENOMEM

Insufficient free memory exists to allocate a message.

SEE ALSO