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

COPYRIGHT

       Copyright (C) 2002, 2003, 2004, 2005, 2006, 2007 Simon Josefsson.
       Permission  is  granted  to make and distribute verbatim copies of this
       manual provided the copyright notice and  this  permission  notice  are
       preserved on all copies.

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.2         stringprep_locale_charset(3)