getCharset

Obtains the character set for the [current locale][setlocale]; you might use this character set as an argument to [glib.global.convert], to convert from the current locale's encoding to some other encoding. (Frequently [glib.global.localeToUtf8] and [glib.global.localeFromUtf8] are nice shortcuts, though.)

On Windows the character set returned by this function is the so-called system default ANSI code-page. That is the character set used by the "narrow" versions of C library and Win32 functions that handle file names. It might be different from the character set used by the C library's current locale.

On Linux, the character set is found by consulting nl_langinfo() if available. If not, the environment variables LC_ALL, LC_CTYPE, LANG and CHARSET are queried in order. nl_langinfo() returns the C locale if no locale has been loaded by setlocale().

The return value is true if the locale's encoding is UTF-8, in that case you can perhaps avoid calling [glib.global.convert].

The string returned in charset is not allocated, and should not be freed.