gconstpointer g_bytes_get_region ( GBytes* bytes, gsize element_size, gsize offset, gsize n_elements )
Gets a pointer to a region in
The region starts at
offset many bytes from the start of the data
n_elements many elements of
n_elements may be zero, but
element_size must always be non-zero.
element_size is a static constant (eg: sizeof a struct).
This function does careful bounds checking (including checking for
arithmetic overflows) and returns a non-
NULL pointer if the
specified region lies entirely within the
bytes. If the region is
in some way out of range, or if an overflow has occurred, then
Note: it is possible to have a valid zero-size region. In this case,
the returned pointer will be equal to the base pointer of the data of
offset. This will be non-
NULL except for the case
bytes itself was a zero-sized region. Since it is unlikely
that you will be using this function to check for a zero-sized region
in a zero-sized
NULL effectively always means “error”.
A non-zero element size.
An offset to the start of the region within the
The number of elements in the region.