Function

GLib-2.0 ▶ GLib ▶ filename_to_utf8

  • Converts a string which is in the encoding used by GLib for filenames into a UTF-8 string. Note that on Windows GLib uses UTF-8 for filenames; on other platforms, this function indirectly depends on the current locale.

    The input string shall not contain nul characters even if the len argument is positive. A nul character found inside the string will result in error GLib.ConvertError.ILLEGAL_SEQUENCE. If the source encoding is not UTF-8 and the conversion output contains a nul character, the error GLib.ConvertError.EMBEDDED_NUL is set and the function returns null. Use g_convert() to produce output that may contain embedded nul characters.

    Parameters

    • opsysstring: string

      a string in the encoding for filenames

    • len: number

      the length of the string, or -1 if the string is nul-terminated (Note that some encodings may allow nul bytes to occur inside strings. In that case, using -1 for the len parameter is unsafe)

    Returns [string, number, number]

    The converted string, or null on an error.