aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSam Varshavchik <mrsam@courier-mta.com>2015-08-07 12:59:25 +0200
committerMichael Kerrisk <mtk.manpages@gmail.com>2015-08-07 12:59:25 +0200
commit665d98c5fe12b84665afd24828e1e0c232ca816a (patch)
treec53b30f85a1da60bac03029f7fee972676fc11bd
parentaabe0499f3c837735a80f220201400dfde8b34e5 (diff)
downloadman-pages-665d98c5fe12b84665afd24828e1e0c232ca816a.tar.gz
nl_langinfo.3: Add documentation for nl_langinfo_l(3)
Signed-off-by: Michael Kerrisk <mtk.manpages@gmail.com>
-rw-r--r--man3/nl_langinfo.321
1 files changed, 17 insertions, 4 deletions
diff --git a/man3/nl_langinfo.3 b/man3/nl_langinfo.3
index bd70ad02fa..b24dfca40e 100644
--- a/man3/nl_langinfo.3
+++ b/man3/nl_langinfo.3
@@ -13,22 +13,33 @@
.\"
.\" Corrected prototype, 2002-10-18, aeb
.\"
-.TH NL_LANGINFO 3 2015-03-02 "GNU" "Linux Programmer's Manual"
+.TH NL_LANGINFO 3 2015-07-31 "GNU" "Linux Programmer's Manual"
.SH NAME
-nl_langinfo \- query language and locale information
+nl_langinfo, nl_langinfo_l \- query language and locale information
.SH SYNOPSIS
.nf
.B #include <langinfo.h>
.sp
.BI "char *nl_langinfo(nl_item " item );
+.sp
+.BI "char *nl_langinfo_l(nl_item " item ", locale_t " locale );
.fi
.SH DESCRIPTION
The
.BR nl_langinfo ()
-function provides access to locale information
+and
+.BR nl_langinfo_l ()
+functions provide access to locale information
in a more flexible way than
.BR localeconv (3)
does.
+.BR nl_langinfo()
+returns \fIitem\fP from the program's current global
+locale.
+.BR nl_langinfo()
+returns \fIitem\fP from locale object \fIlocale\fP which was
+previously created by
+.BR newlocale (1).
Individual and additional elements of the locale categories can
be queried.
.PP
@@ -103,7 +114,9 @@ If no locale has been selected by
.BR setlocale (3)
for the appropriate category,
.BR nl_langinfo ()
-returns a pointer to the corresponding string in the
+and
+.BR nl_langinfo_l ()
+return a pointer to the corresponding string in the
"C" locale.
.PP
If \fIitem\fP is not valid, a pointer to an empty string is returned.