Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

stringprep_locale_charset (3)

Name

stringprep_locale_charset - API function

Synopsis

#include <stringprep.h>

const char * stringprep_locale_charset( void);

Description

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>.
       General guidelines for reporting bugs: http://www.gnu.org/gethelp/
       GNU Libidn home page: http://www.gnu.org/software/libidn/


COPYRIGHT
       Copyright (C) 2002-2016 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.


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | library/libidn   |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

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.  As an alternative you
       may obtain the manual from:

              http://www.gnu.org/software/libidn/manual/

NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This    software    was    built    from    source     available     at
       https://github.com/oracle/solaris-userland.    The  original  community
       source                was                downloaded                from
       https://ftp.gnu.org/gnu/libidn/libidn-1.34.tar.gz.

       Further information about this software can be found on the open source
       community website at https://www.gnu.org/software/libidn.



libidn                               1.34
                                                  stringprep_locale_charset(3)