ByteReader.dupStringUtf16

Free-function: g_free

Returns a newly-allocated copy of the current data position if there is a NUL-terminated UTF-16 string in the data (this could be an empty string as well), and advances the current position.

No input checking for valid UTF-16 is done. This function is endianness agnostic - you should not assume the UTF-16 characters are in host endianness.

This function will fail if no NUL-terminator was found in in the data.

Note: there is no peek or get variant of this function to ensure correct byte alignment of the UTF-16 string.

class ByteReader
bool
dupStringUtf16
(
out ushort[] str
)

Parameters

str ushort[]

address of a guint16 pointer variable in which to store the result

Return Value

Type: bool

TRUE if a string could be read, FALSE otherwise. The string put into str must be freed with g_free() when no longer needed.