Obtains the character set for the [current locale][setlocale]; you
might use this character set as an argument to g_convert(), to convert
from the current locale’s encoding to some other encoding. (Frequently
g_locale_from_utf8() 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
available. If not, the environment variables
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 g_convert().
The string returned in
charset is not allocated, and should not be freed.
Return location for character set name, or
The argument will be set by the function. The argument can be
The data is owned by the function. The value is a NUL terminated UTF-8 string.