aboutsummaryrefslogtreecommitdiff
path: root/docs/man/nng_msg_header_append.3.adoc
diff options
context:
space:
mode:
authorGarrett D'Amore <garrett@damore.org>2018-08-31 11:25:50 -0700
committerGarrett D'Amore <garrett@damore.org>2018-08-31 11:25:50 -0700
commit49c8c264057c4c7b0f9ff45f352168cb1deeb1a1 (patch)
tree30836d3dfe020380216113784b4ab74c633d9b45 /docs/man/nng_msg_header_append.3.adoc
parent2426984f20a8363e52fef5cd69221da05c0b1756 (diff)
downloadnng-49c8c264057c4c7b0f9ff45f352168cb1deeb1a1.tar.gz
nng-49c8c264057c4c7b0f9ff45f352168cb1deeb1a1.tar.bz2
nng-49c8c264057c4c7b0f9ff45f352168cb1deeb1a1.zip
fixes #691 Desire 16 and 64 bit message manipulators
We use macros to generate message bodies for each of the various variants, reducing source code size (but not compiled size). The documentation is updated to indicate each of these variants.
Diffstat (limited to 'docs/man/nng_msg_header_append.3.adoc')
-rw-r--r--docs/man/nng_msg_header_append.3.adoc15
1 files changed, 8 insertions, 7 deletions
diff --git a/docs/man/nng_msg_header_append.3.adoc b/docs/man/nng_msg_header_append.3.adoc
index b711b9f6..08e48b74 100644
--- a/docs/man/nng_msg_header_append.3.adoc
+++ b/docs/man/nng_msg_header_append.3.adoc
@@ -11,7 +11,7 @@
== NAME
-nng_msg_header_append, nng_msg_header_append_u32 - append to message header
+nng_msg_header_append - append to message header
== SYNOPSIS
@@ -20,23 +20,24 @@ nng_msg_header_append, nng_msg_header_append_u32 - append to message header
#include <nng/nng.h>
int nng_msg_header_append(nng_msg *msg, const void *val, size_t size);
-
+int nng_msg_header_append_u16(nng_msg *msg, uint16_t val16);
int nng_msg_header_append_u32(nng_msg *msg, uint32_t val32);
+int nng_msg_header_append_u64(nng_msg *msg, uint64_t val64);
----
== DESCRIPTION
-The `nng_msg_header_append()` and `nng_msg_header_append_u32()`
-functions append data to
+The `nng_msg_header_append()` family of functions appends data to
the end of the headers of message _msg_, reallocating it if necessary.
The first function appends _size_ bytes, copying them from _val_.
-The second function appends the value _val32_ in network-byte order
-(big-endian).
+
+The remaining functions append the value (such as _val32_) in
+network-byte order (big-endian).
== RETURN VALUES
-This function returns 0 on success, and non-zero otherwise.
+These functions return 0 on success, and non-zero otherwise.
== ERRORS