mirror of https://github.com/mkerrisk/man-pages
121 lines
3.7 KiB
Groff
121 lines
3.7 KiB
Groff
.\" Copyright (c) 2001 Markus Kuhn <mkuhn@acm.org>
|
|
.\"
|
|
.\" This is free documentation; you can redistribute it and/or
|
|
.\" modify it under the terms of the GNU General Public License as
|
|
.\" published by the Free Software Foundation; either version 2 of
|
|
.\" the License, or (at your option) any later version.
|
|
.\"
|
|
.\" References consulted:
|
|
.\" GNU glibc-2 manual
|
|
.\" OpenGroup's Single Unix specification http://www.UNIX-systems.org/online.html
|
|
.\"
|
|
.\" Corrected prototype, 2002-10-18, aeb
|
|
.\"
|
|
.TH NL_LANGINFO 3 2001-05-11 "GNU" "Linux Programmer's Manual"
|
|
.SH NAME
|
|
nl_langinfo \- query language and locale information
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B #include <langinfo.h>
|
|
.sp
|
|
.BI "char *nl_langinfo(nl_item " item );
|
|
.fi
|
|
.SH DESCRIPTION
|
|
The
|
|
.BR nl_langinfo ()
|
|
function provides access to locale information
|
|
in a more flexible way than
|
|
.BR localeconv (3)
|
|
does.
|
|
Individual and additional elements of the locale categories can
|
|
be queried.
|
|
.PP
|
|
Examples for the locale elements that can be specified in \fIitem\fP
|
|
using the constants defined in \fI<langinfo.h>\fP are:
|
|
.TP
|
|
.BR CODESET \ (LC_CTYPE)
|
|
Return a string with the name of the character encoding used in the
|
|
selected locale, such as "UTF-8", "ISO-8859-1", or "ANSI_X3.4-1968"
|
|
(better known as US-ASCII).
|
|
This is the same string that you get with
|
|
"locale charmap".
|
|
For a list of character encoding names,
|
|
try "locale \-m", cf.\&
|
|
.BR locale (1).
|
|
.TP
|
|
.BR D_T_FMT \ (LC_TIME)
|
|
Return a string that can be used as a format string for
|
|
.BR strftime (3)
|
|
to represent time and date in a locale-specific way.
|
|
.TP
|
|
.BR D_FMT \ (LC_TIME)
|
|
Return a string that can be used as a format string for
|
|
.BR strftime (3)
|
|
to represent a date in a locale-specific way.
|
|
.TP
|
|
.BR T_FMT \ (LC_TIME)
|
|
Return a string that can be used as a format string for
|
|
.BR strftime (3)
|
|
to represent a time in a locale-specific way.
|
|
.TP
|
|
.BR DAY_ "{1\(en7} (LC_TIME)"
|
|
Return name of the \fIn\fP-th day of the week. [Warning: this follows
|
|
the US convention DAY_1 = Sunday, not the international convention
|
|
(ISO 8601) that Monday is the first day of the week.]
|
|
.TP
|
|
.BR ABDAY_ "{1\(en7} (LC_TIME)"
|
|
Return abbreviated name of the \fIn\fP-th day of the week.
|
|
.TP
|
|
.BR MON_ "{1\(en12} (LC_TIME)"
|
|
Return name of the \fIn\fP-th month.
|
|
.TP
|
|
.BR ABMON_ "{1\(en12} (LC_TIME)"
|
|
Return abbreviated name of the \fIn\fP-th month.
|
|
.TP
|
|
.BR RADIXCHAR \ (LC_NUMERIC)
|
|
Return radix character (decimal dot, decimal comma, etc.).
|
|
.TP
|
|
.BR THOUSEP \ (LC_NUMERIC)
|
|
Return separator character for thousands (groups of three digits).
|
|
.TP
|
|
.BR YESEXPR \ (LC_MESSAGES)
|
|
Return a regular expression that can be used with the
|
|
.BR regex (3)
|
|
function to recognize a positive response to a yes/no question.
|
|
.TP
|
|
.BR NOEXPR \ (LC_MESSAGES)
|
|
Return a regular expression that can be used with the
|
|
.BR regex (3)
|
|
function to recognize a negative response to a yes/no question.
|
|
.TP
|
|
.BR CRNCYSTR \ (LC_MONETARY)
|
|
Return the currency symbol, preceded by "\-" if the symbol should
|
|
appear before the value, "+" if the symbol should appear after the
|
|
value, or "." if the symbol should replace the radix character.
|
|
.PP
|
|
The above list covers just some examples of items that can be requested.
|
|
For a more detailed list, consult
|
|
.IR "The GNU C Library Reference Manual" .
|
|
.SH "RETURN VALUE"
|
|
If no locale has been selected for the appropriate category,
|
|
.BR nl_langinfo ()
|
|
returns 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.
|
|
.PP
|
|
This pointer may point to static data that may be overwritten on the
|
|
next call to
|
|
.BR nl_langinfo ()
|
|
or
|
|
.BR setlocale (3).
|
|
.SH "CONFORMING TO"
|
|
SUSv2, POSIX.1-2001.
|
|
.SH "SEE ALSO"
|
|
.BR locale (1),
|
|
.BR localeconv (3),
|
|
.BR setlocale (3),
|
|
.BR charsets (7),
|
|
.BR locale (7)
|
|
The GNU C Library Reference Manual
|