NAME
stringprep_locale_charset - API function
SYNOPSIS
#include <stringprep.h>
const char * stringprep_locale_charset( void);
ARGUMENTS
void
DESCRIPTION
Find out current locale charset. The function respect the CHARSET
environment variable, but typically uses nl_langinfo(CODESET) when it
is supported. It fall back on "ASCII" if CHARSET isn’t set and
nl_langinfo isn’t supported or return anything.
Note that this function return the application’s locale’s preferred
charset (or thread’s locale’s preffered charset, if your system support
thread-specific locales). It does not return what the system may be
using. Thus, if you receive data from external sources you cannot in
general use this function to guess what charset it is encoded in. Use
stringprep_convert from the external representation into the charset
returned by this function, to have data in the locale encoding.
RETURN VALUE
Return the character set used by the current locale. It will never
return NULL, but use "ASCII" as a fallback.
REPORTING BUGS
Report bugs to <bug-libidn@gnu.org>. GNU Libidn home page:
http://www.gnu.org/software/libidn/ General help using GNU software:
http://www.gnu.org/gethelp/
COPYRIGHT
Copyright © 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010 Simon
Josefsson.
Copying and distribution of this file, with or without modification,
are permitted in any medium without royalty provided the copyright
notice and this notice are preserved.
SEE ALSO
The full documentation for libidn is maintained as a Texinfo manual.
If the info and libidn programs are properly installed at your site,
the command
info libidn
should give you access to the complete manual.