= nng_msg_header_trim(3) // // Copyright 2018 Staysail Systems, Inc. // Copyright 2018 Capitar IT Group BV // // This document is supplied under the terms of the MIT License, a // copy of which should be located in the distribution where this // file was obtained (LICENSE.txt). A copy of the license may also be // found online at https://opensource.org/licenses/MIT. // == NAME nng_msg_header_trim, nng_msg_header_trim_u32 - remove data from start of message header == SYNOPSIS [source, c] ---- #include int nng_msg_header_trim(nng_msg *msg, size_t size); int nng_msg_header_trim_u32(nng_msg *msg, uint32_t *val32); ---- == DESCRIPTION The `nng_msg_header_trim()` and `nng_msg_header_trim_u32()` functions remove data from the start of the header of message _msg_. The first function removes _size_ bytes. The second function removes 4 bytes, and stores them in the value _val32_, after converting them from network-byte order (big-endian) to native byte order. == RETURN VALUES This function returns 0 on success, and non-zero otherwise. == ERRORS [horizontal] `NNG_EINVAL`:: The message header is too short to remove the requested data. == SEE ALSO [.text-left] <>, <>, <>, <>, <>, <>, <>, <>, <>, <>