stringprep_locale_charset(3)					      libidn					      stringprep_locale_charset(3)

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 (C) 2002-2012 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.

libidn								       1.25					      stringprep_locale_charset(3)