Free-function: g_free
Returns a newly-allocated copy of the current data position if there is a NUL-terminated UTF-32 string in the data (this could be an empty string as well), and advances the current position.
No input checking for valid UTF-32 is done. This function is endianness agnostic - you should not assume the UTF-32 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-32 string.
Parameters
str | address of a #guint32 pointer variable in which to store the result |
Returns
true if a string could be read, false otherwise. The
string put into str must be freed with [glib.global.gfree] when no longer needed.