Function
GLibutf8_make_valid
since: 2.52
Declaration [src]
gchar*
g_utf8_make_valid(
constgchar*str,
gssizelen
)
Description [src]
If the provided string is valid UTF-8, return a copy of it. If not, return a copy in which bytes that could not be interpreted as valid Unicode are replaced with the Unicode replacement character (U+FFFD).
For example, this is an appropriate function to use if you have received a string that was incorrectly declared to be UTF-8, and you need a valid UTF-8 version of it that can be logged or displayed to the user, with the assumption that it is close enough to ASCII or UTF-8 to be mostly readable as-is.
Available since: 2.52
Parameters
str-
Type:
const gchar*String to coerce into UTF-8.
The data is owned by the caller of the function.The value is a NUL terminated UTF-8 string. len-
Type:
gssizeThe maximum length of
strto use, in bytes. Iflenis negative, then the string is nul-terminated.
Return value
Type: gchar*
A valid UTF-8 string whose content resembles str.