From d63b1970c3ceac1a190be459b1f2766b530fe4b0 Mon Sep 17 00:00:00 2001 From: "Staysail Systems, Inc." Date: Thu, 14 Sep 2023 00:35:45 -0700 Subject: v1.5.2 docs --- man/v1.5.2/nng_msg_insert.3.html | 99 ++++++++++++++++++++++++++++++++++++++++ 1 file changed, 99 insertions(+) create mode 100644 man/v1.5.2/nng_msg_insert.3.html (limited to 'man/v1.5.2/nng_msg_insert.3.html') diff --git a/man/v1.5.2/nng_msg_insert.3.html b/man/v1.5.2/nng_msg_insert.3.html new file mode 100644 index 00000000..c385e66e --- /dev/null +++ b/man/v1.5.2/nng_msg_insert.3.html @@ -0,0 +1,99 @@ +--- +version: v1.5.2 +layout: manpage_v2 +title: nng_msg_insert(3) +--- +

nng_msg_insert(3)

+
+

NAME

+
+
+

nng_msg_insert - prepend to message body

+
+
+
+
+

SYNOPSIS

+
+
+
+
#include <nng/nng.h>
+
+int nng_msg_insert(nng_msg *msg, const void *val, size_t size);
+int nng_msg_insert_u16(nng_msg *msg, uint16_t val16);
+int nng_msg_insert_u32(nng_msg *msg, uint32_t val32);
+int nng_msg_insert_u64(nng_msg *msg, uint64_t val64);
+
+
+
+
+
+

DESCRIPTION

+
+
+

The nng_msg_insert() family of functions prepends data to +the front of the body of message msg, reallocating it if necessary. +The first function prepends size bytes, copying them from val. +The remaining functions prepend the specified value (such as val32) +in network-byte order (big-endian).

+
+
+ + + + + +
+ + +These functions make use of space pre-allocated in front of the +message body if available, so they can often avoid performing any reallocation. +Applications should use these instead of reallocating and copying message +content themselves, in order to benefit from this capability. +
+
+
+
+
+

RETURN VALUES

+
+
+

These functions return 0 on success, and non-zero otherwise.

+
+
+
+
+

ERRORS

+
+
+ + + + + +
+NNG_ENOMEM + +

Insufficient free memory exists.

+
+
+
+
+
+

SEE ALSO

+
+
+

nng_msg_alloc(3), +nng_msg_append(3), +nng_msg_body(3), +nng_msg_chop(3), +nng_msg_free(3), +nng_msg_len(3), +nng_msg_realloc(3), +nng_msg_trim(3), +nng_strerror(3), +nng_msg(5), +nng(7)

+
+
+
-- cgit v1.2.3-70-g09d2