stringprep_locale_charset.3   [plain text]

.\" DO NOT MODIFY THIS FILE!  It was generated by gdoc.
.TH "stringprep_locale_charset" 3 "0.6.14" "libidn" "libidn"
.SH NAME
stringprep_locale_charset \- return charset used in current locale
.SH SYNOPSIS
.B #include <stringprep.h>
.sp
.BI "const char * stringprep_locale_charset( " void ");"
.SH ARGUMENTS
.IP " void" 12
.SH "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.
.SH "RETURN VALUE"
Return the character set used by the current locale.
It will never return NULL, but use "ASCII" as a fallback.
.SH "REPORTING BUGS"
Report bugs to <bug-libidn@gnu.org>.
.SH COPYRIGHT
Copyright \(co 2002, 2003, 2004, 2005, 2006, 2007 Simon Josefsson.
.br
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.
.SH "SEE ALSO"
The full documentation for
.B libidn
is maintained as a Texinfo manual.  If the
.B info
and
.B libidn
programs are properly installed at your site, the command
.IP
.B info libidn
.PP
should give you access to the complete manual.