or null on an error, and error will be set.
localeFromUtf8
fn
ubyte[] localeFromUtf8(ubyte[] utf8string, out size_t bytesRead)Converts a string from UTF-8 to the encoding used for strings by the C runtime (usually the same as that used by the operating system) in the [current locale][setlocale]. On Windows this means the system codepage.
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 G_CONVERT_ERROR_ILLEGAL_SEQUENCE. Use [glib.global.convert] to convert input that may contain embedded nul characters.
Parameters
utf8string | a UTF-8 encoded string |
bytesRead | location to store the number of bytes in the input string that were successfully converted, or null. Even if the conversion was successful, this may be less than len if there were partial characters at the end of the input. If the error G_CONVERT_ERROR_ILLEGAL_SEQUENCE occurs, the value stored will be the byte offset after the last valid input sequence. |
Returns
A newly-allocated buffer containing the converted string,
Throws
[ErrorWrap]