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-2013 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.