validate


Description:

[ CCode ( cname = "g_utf8_validate" ) ]
public bool validate (ssize_t max_len = -1, out char* end = null)

Validates UTF-8 encoded text.

str is the text to validate; if str is nul-terminated, then max_len can be `-1`, otherwise max_len should be the number of bytes to validate.

If end is non-`NULL`, then the end of the valid range will be stored there. This is the first byte of the first invalid character if some bytes were invalid, or the end of the text being validated otherwise — either the trailing nul byte, or the first byte beyond max_len (if it’s positive).

Note that `g_utf8_validate()` returns `FALSE` if max_len is positive and any of the max_len bytes are nul.

Returns `TRUE` if all of str was valid. Many GLib and GTK routines require valid UTF-8 as input; so data read from a file or the network should be checked with `g_utf8_validate()` before doing anything else with it.

Parameters:

max_len

max bytes to validate, or `-1` to go until nul

end

return location for end of valid data

str

a pointer to character data

Returns:

`TRUE` if the text was valid UTF-8