|
Packit |
7cfc04 |
'\" et
|
|
Packit |
7cfc04 |
.TH langinfo.h "0P" 2013 "IEEE/The Open Group" "POSIX Programmer's Manual"
|
|
Packit |
7cfc04 |
.SH PROLOG
|
|
Packit |
7cfc04 |
This manual page is part of the POSIX Programmer's Manual.
|
|
Packit |
7cfc04 |
The Linux implementation of this interface may differ (consult
|
|
Packit |
7cfc04 |
the corresponding Linux manual page for details of Linux behavior),
|
|
Packit |
7cfc04 |
or the interface may not be implemented on Linux.
|
|
Packit |
7cfc04 |
|
|
Packit |
7cfc04 |
.SH NAME
|
|
Packit |
7cfc04 |
langinfo.h
|
|
Packit |
7cfc04 |
\(em language information constants
|
|
Packit |
7cfc04 |
.SH SYNOPSIS
|
|
Packit |
7cfc04 |
.LP
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
#include <langinfo.h>
|
|
Packit |
7cfc04 |
.fi
|
|
Packit |
7cfc04 |
.SH DESCRIPTION
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
.IR <langinfo.h>
|
|
Packit |
7cfc04 |
header shall define the symbolic constants used to identify items of
|
|
Packit |
7cfc04 |
.IR langinfo
|
|
Packit |
7cfc04 |
data (see
|
|
Packit |
7cfc04 |
\fInl_langinfo\fR()).
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
.IR <langinfo.h>
|
|
Packit |
7cfc04 |
header shall define the
|
|
Packit |
7cfc04 |
.BR locale_t
|
|
Packit |
7cfc04 |
type as described in
|
|
Packit |
7cfc04 |
.IR <locale.h> .
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
.IR <langinfo.h>
|
|
Packit |
7cfc04 |
header shall define the
|
|
Packit |
7cfc04 |
.BR nl_item
|
|
Packit |
7cfc04 |
type as described in
|
|
Packit |
7cfc04 |
.IR <nl_types.h> .
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
.IR <langinfo.h>
|
|
Packit |
7cfc04 |
header shall define the following symbolic constants with type
|
|
Packit |
7cfc04 |
.BR nl_item .
|
|
Packit |
7cfc04 |
The entries under
|
|
Packit |
7cfc04 |
.BR Category
|
|
Packit |
7cfc04 |
indicate in which
|
|
Packit |
7cfc04 |
\fIsetlocale\fR()
|
|
Packit |
7cfc04 |
category each item is defined.
|
|
Packit |
7cfc04 |
.TS
|
|
Packit |
7cfc04 |
box center tab(!);
|
|
Packit |
7cfc04 |
cB | cB | cB
|
|
Packit |
7cfc04 |
l1 | lI1 | l.
|
|
Packit |
7cfc04 |
Constant!Category!Meaning
|
|
Packit |
7cfc04 |
_
|
|
Packit |
7cfc04 |
CODESET!LC_CTYPE!Codeset name.
|
|
Packit |
7cfc04 |
D_T_FMT!LC_TIME!String for formatting date and time.
|
|
Packit |
7cfc04 |
D_FMT!LC_TIME!Date format string.
|
|
Packit |
7cfc04 |
T_FMT!LC_TIME!Time format string.
|
|
Packit |
7cfc04 |
T_FMT_AMPM!LC_TIME!a.m. or p.m. time format string.
|
|
Packit |
7cfc04 |
AM_STR!LC_TIME!Ante-meridiem affix.
|
|
Packit |
7cfc04 |
PM_STR!LC_TIME!Post-meridiem affix.
|
|
Packit |
7cfc04 |
DAY_1!LC_TIME!Name of the first day of the week (for example, Sunday).
|
|
Packit |
7cfc04 |
DAY_2!LC_TIME!Name of the second day of the week (for example, Monday).
|
|
Packit |
7cfc04 |
DAY_3!LC_TIME!Name of the third day of the week (for example, Tuesday).
|
|
Packit |
7cfc04 |
DAY_4!LC_TIME!Name of the fourth day of the week
|
|
Packit |
7cfc04 |
!!(for example, Wednesday).
|
|
Packit |
7cfc04 |
DAY_5!LC_TIME!Name of the fifth day of the week (for example, Thursday).
|
|
Packit |
7cfc04 |
DAY_6!LC_TIME!Name of the sixth day of the week (for example, Friday).
|
|
Packit |
7cfc04 |
DAY_7!LC_TIME!Name of the seventh day of the week
|
|
Packit |
7cfc04 |
!!(for example, Saturday).
|
|
Packit |
7cfc04 |
ABDAY_1!LC_TIME!Abbreviated name of the first day of the week.
|
|
Packit |
7cfc04 |
ABDAY_2!LC_TIME!Abbreviated name of the second day of the week.
|
|
Packit |
7cfc04 |
ABDAY_3!LC_TIME!Abbreviated name of the third day of the week.
|
|
Packit |
7cfc04 |
ABDAY_4!LC_TIME!Abbreviated name of the fourth day of the week.
|
|
Packit |
7cfc04 |
ABDAY_5!LC_TIME!Abbreviated name of the fifth day of the week.
|
|
Packit |
7cfc04 |
ABDAY_6!LC_TIME!Abbreviated name of the sixth day of the week.
|
|
Packit |
7cfc04 |
ABDAY_7!LC_TIME!Abbreviated name of the seventh day of the week.
|
|
Packit |
7cfc04 |
MON_1!LC_TIME!Name of the first month of the year.
|
|
Packit |
7cfc04 |
MON_2!LC_TIME!Name of the second month.
|
|
Packit |
7cfc04 |
MON_3!LC_TIME!Name of the third month.
|
|
Packit |
7cfc04 |
MON_4!LC_TIME!Name of the fourth month.
|
|
Packit |
7cfc04 |
MON_5!LC_TIME!Name of the fifth month.
|
|
Packit |
7cfc04 |
MON_6!LC_TIME!Name of the sixth month.
|
|
Packit |
7cfc04 |
MON_7!LC_TIME!Name of the seventh month.
|
|
Packit |
7cfc04 |
MON_8!LC_TIME!Name of the eighth month.
|
|
Packit |
7cfc04 |
MON_9!LC_TIME!Name of the ninth month.
|
|
Packit |
7cfc04 |
MON_10!LC_TIME!Name of the tenth month.
|
|
Packit |
7cfc04 |
MON_11!LC_TIME!Name of the eleventh month.
|
|
Packit |
7cfc04 |
MON_12!LC_TIME!Name of the twelfth month.
|
|
Packit |
7cfc04 |
ABMON_1!LC_TIME!Abbreviated name of the first month.
|
|
Packit |
7cfc04 |
ABMON_2!LC_TIME!Abbreviated name of the second month.
|
|
Packit |
7cfc04 |
ABMON_3!LC_TIME!Abbreviated name of the third month.
|
|
Packit |
7cfc04 |
ABMON_4!LC_TIME!Abbreviated name of the fourth month.
|
|
Packit |
7cfc04 |
ABMON_5!LC_TIME!Abbreviated name of the fifth month.
|
|
Packit |
7cfc04 |
ABMON_6!LC_TIME!Abbreviated name of the sixth month.
|
|
Packit |
7cfc04 |
ABMON_7!LC_TIME!Abbreviated name of the seventh month.
|
|
Packit |
7cfc04 |
ABMON_8!LC_TIME!Abbreviated name of the eighth month.
|
|
Packit |
7cfc04 |
ABMON_9!LC_TIME!Abbreviated name of the ninth month.
|
|
Packit |
7cfc04 |
ABMON_10!LC_TIME!Abbreviated name of the tenth month.
|
|
Packit |
7cfc04 |
ABMON_11!LC_TIME!Abbreviated name of the eleventh month.
|
|
Packit |
7cfc04 |
ABMON_12!LC_TIME!Abbreviated name of the twelfth month.
|
|
Packit |
7cfc04 |
ERA!LC_TIME!Era description segments.
|
|
Packit |
7cfc04 |
ERA_D_FMT!LC_TIME!Era date format string.
|
|
Packit |
7cfc04 |
ERA_D_T_FMT!LC_TIME!Era date and time format string.
|
|
Packit |
7cfc04 |
ERA_T_FMT!LC_TIME!Era time format string.
|
|
Packit |
7cfc04 |
ALT_DIGITS!LC_TIME!Alternative symbols for digits.
|
|
Packit |
7cfc04 |
RADIXCHAR!LC_NUMERIC!Radix character.
|
|
Packit |
7cfc04 |
THOUSEP!LC_NUMERIC!Separator for thousands.
|
|
Packit |
7cfc04 |
YESEXPR!LC_MESSAGES!Affirmative response expression.
|
|
Packit |
7cfc04 |
NOEXPR!LC_MESSAGES!Negative response expression.
|
|
Packit |
7cfc04 |
CRNCYSTR!LC_MONETARY!T{
|
|
Packit |
7cfc04 |
Local currency symbol, preceded by
|
|
Packit |
7cfc04 |
.BR '\(mi'
|
|
Packit |
7cfc04 |
if the symbol should appear before the value,
|
|
Packit |
7cfc04 |
.BR '+'
|
|
Packit |
7cfc04 |
if the symbol should appear after the value, or
|
|
Packit |
7cfc04 |
.BR '.'
|
|
Packit |
7cfc04 |
if the symbol should replace the radix character. If the local
|
|
Packit |
7cfc04 |
currency symbol is the empty string, implementations may return
|
|
Packit |
7cfc04 |
the empty string (\c
|
|
Packit |
7cfc04 |
.BR \(dq\&\(dq ).
|
|
Packit |
7cfc04 |
T}
|
|
Packit |
7cfc04 |
.TE
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
If the locale's values for
|
|
Packit |
7cfc04 |
.BR p_cs_precedes
|
|
Packit |
7cfc04 |
and
|
|
Packit |
7cfc04 |
.BR n_cs_precedes
|
|
Packit |
7cfc04 |
do not match, the value of
|
|
Packit |
7cfc04 |
.IR nl_langinfo (CRNCYSTR)
|
|
Packit |
7cfc04 |
and
|
|
Packit |
7cfc04 |
.IR nl_langinfo_l (CRNCYSTR,loc)
|
|
Packit |
7cfc04 |
is unspecified.
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
The following shall be declared as a function and may also be defined
|
|
Packit |
7cfc04 |
as a macro. A function prototype shall be provided.
|
|
Packit |
7cfc04 |
.sp
|
|
Packit |
7cfc04 |
.RS 4
|
|
Packit |
7cfc04 |
.nf
|
|
Packit |
7cfc04 |
\fB
|
|
Packit |
7cfc04 |
char *nl_langinfo(nl_item);
|
|
Packit |
7cfc04 |
char *nl_langinfo_l(nl_item, locale_t);
|
|
Packit |
7cfc04 |
.fi \fR
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
.RE
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
Inclusion of the
|
|
Packit |
7cfc04 |
.IR <langinfo.h>
|
|
Packit |
7cfc04 |
header may also make visible all symbols from
|
|
Packit |
7cfc04 |
.IR <nl_types.h> .
|
|
Packit |
7cfc04 |
.LP
|
|
Packit |
7cfc04 |
.IR "The following sections are informative."
|
|
Packit |
7cfc04 |
.SH "APPLICATION USAGE"
|
|
Packit |
7cfc04 |
Wherever possible, users are advised to use functions compatible with
|
|
Packit |
7cfc04 |
those in the ISO\ C standard to access items of
|
|
Packit |
7cfc04 |
.IR langinfo
|
|
Packit |
7cfc04 |
data. In particular, the
|
|
Packit |
7cfc04 |
\fIstrftime\fR()
|
|
Packit |
7cfc04 |
function should be used to access date and time information defined in
|
|
Packit |
7cfc04 |
category
|
|
Packit |
7cfc04 |
.IR LC_TIME .
|
|
Packit |
7cfc04 |
The
|
|
Packit |
7cfc04 |
\fIlocaleconv\fR()
|
|
Packit |
7cfc04 |
function should be used to access information corresponding to
|
|
Packit |
7cfc04 |
RADIXCHAR, THOUSEP, and CRNCYSTR.
|
|
Packit |
7cfc04 |
.SH RATIONALE
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "FUTURE DIRECTIONS"
|
|
Packit |
7cfc04 |
None.
|
|
Packit |
7cfc04 |
.SH "SEE ALSO"
|
|
Packit |
7cfc04 |
.IR "Chapter 7" ", " "Locale",
|
|
Packit |
7cfc04 |
.IR "\fB<locale.h>\fP",
|
|
Packit |
7cfc04 |
.IR "\fB<nl_types.h>\fP"
|
|
Packit |
7cfc04 |
.P
|
|
Packit |
7cfc04 |
The System Interfaces volume of POSIX.1\(hy2008,
|
|
Packit |
7cfc04 |
.IR "\fInl_langinfo\fR\^(\|)",
|
|
Packit |
7cfc04 |
.IR "\fIlocaleconv\fR\^(\|)",
|
|
Packit |
7cfc04 |
.IR "\fIstrfmon\fR\^(\|)",
|
|
Packit |
7cfc04 |
.IR "\fIstrftime\fR\^(\|)"
|
|
Packit |
7cfc04 |
.SH COPYRIGHT
|
|
Packit |
7cfc04 |
Portions of this text are reprinted and reproduced in electronic form
|
|
Packit |
7cfc04 |
from IEEE Std 1003.1, 2013 Edition, Standard for Information Technology
|
|
Packit |
7cfc04 |
-- Portable Operating System Interface (POSIX), The Open Group Base
|
|
Packit |
7cfc04 |
Specifications Issue 7, Copyright (C) 2013 by the Institute of
|
|
Packit |
7cfc04 |
Electrical and Electronics Engineers, Inc and The Open Group.
|
|
Packit |
7cfc04 |
(This is POSIX.1-2008 with the 2013 Technical Corrigendum 1 applied.) In the
|
|
Packit |
7cfc04 |
event of any discrepancy between this version and the original IEEE and
|
|
Packit |
7cfc04 |
The Open Group Standard, the original IEEE and The Open Group Standard
|
|
Packit |
7cfc04 |
is the referee document. The original Standard can be obtained online at
|
|
Packit |
7cfc04 |
http://www.unix.org/online.html .
|
|
Packit |
7cfc04 |
|
|
Packit |
7cfc04 |
Any typographical or formatting errors that appear
|
|
Packit |
7cfc04 |
in this page are most likely
|
|
Packit |
7cfc04 |
to have been introduced during the conversion of the source files to
|
|
Packit |
7cfc04 |
man page format. To report such errors, see
|
|
Packit |
7cfc04 |
https://www.kernel.org/doc/man-pages/reporting_bugs.html .
|