blob: 4e7feef48cf8ea1d558fc2dcf1b5a876418857e9 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
|
## nng_msg_header_append
Append to message header.
### Synopsis
```c
#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
These functions append data to the end of the headers of message _msg_, reallocating it if necessary.
The `nng_msg_header_append` function appends _size_ bytes, copying them from _val_.
The remaining functions append the value (such as _val32_) in network-byte order (big-endian).
### Return Values
These functions return 0 on success, and non-zero otherwise.
### Errors
[horizontal]
`NNG_ENOMEM`:: Insufficient free memory exists.
### See Also
xref:nng_msg_header.adoc[nng_msg_header],
xref:nng_msg_header_chop.adoc[nng_msg_header_chop],
xref:nng_msg_header_insert.adoc[nng_msg_header_insert],
xref:nng_msg_header_trim.adoc[nng_msg_header_trim]
|
