Obtains the character set for the [current locale][setlocale]; you
might use this character set as an argument to
convert, to
convert from the current locale's encoding to some other encoding.
(Frequently
localeToUtf8 and
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
convert.
The string returned in
charset is not allocated, and
should not be freed.