Function

Gimpany_to_utf8

Declaration [src]

gchar*
gimp_any_to_utf8 (
  const gchar* str,
  gssize len,
  const gchar* warning_format,
  ...
)

Description [src]

This function takes any string (UTF-8 or not) and always returns a valid UTF-8 string.

If str is valid UTF-8, a copy of the string is returned.

If UTF-8 validation fails, g_locale_to_utf8() is tried and if it succeeds the resulting string is returned.

Otherwise, the portion of str that is UTF-8, concatenated with “(invalid UTF-8 string)” is returned. If not even the start of str is valid UTF-8, only “(invalid UTF-8 string)” is returned.

This function is not directly available to language bindings.

Parameters

str

Type: An array of gchar

The string to be converted to UTF-8.

The length of the array is specified in the len argument.

The data is owned by the caller of the function.

Each element is a NUL terminated UTF-8 string.

len

Type: gssize

The length of the string, or -1 if the string is nul-terminated.

warning_format

Type: const gchar*

The message format for the warning message if conversion to UTF-8 fails. See the printf() documentation.

The data is owned by the caller of the function.

The value is a NUL terminated UTF-8 string.

...

Type:

The parameters to insert into the format string.

Return value

Type: gchar*

The UTF-8 string as described above.

The caller of the function takes ownership of the data, and is responsible for freeing it.

The value is a NUL terminated UTF-8 string.