usr/src/man/man3head/langinfo.h.3head

   1 '\" te
   2 .\" Copyright 1989 AT&T. Copyright (c) 2002, Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License").  You may not use this file except in compliance with the License.
   4 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   5 .\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE.  If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
   6 .TH LANGINFO.H 3HEAD "April 9, 2016"
   7 .SH NAME
   8 langinfo.h, langinfo \- language information constants
   9 .SH SYNOPSIS
  10 .LP
  11 .nf
  12 #include <langinfo.h>
  13 .fi
  14
  15 .SH DESCRIPTION
  16 .LP
  17 The <\fBlanginfo.h\fR> header contains the constants used to identify items of
  18 \fBlanginfo\fR data (see \fBnl_langinfo\fR(3C)). The type of the constant,
  19 \fBnl_item\fR, is defined as described in <\fBnl_types.h\fR>.
  20 .sp
  21 .LP
  22 The following constants are defined. The entries under Category indicate in
  23 which \fBsetlocale\fR(3C) category each item is defined.
  24 .sp
  25
  26 .sp
  27 .TS
  28 c | c | c
  29 l | l | l .
  30 Constant        Category        Meaning
  31 _
  32 \fBCODESET\fR   \fBLC_CTYPE\fR  codeset name
  33 _
  34 \fBD_T_FMT\fR   \fBLC_TIME\fR   string for formatting date and time
  35 _
  36 \fBD_FMT\fR     \fBLC_TIME\fR   date format string
  37 _
  38 \fBT_FMT\fR     \fBLC_TIME\fR   time format string
  39 _
  40 \fBT_FMT_AMPM\fR        \fBLC_TIME\fR   a.m. or p.m. time format string
  41 _
  42 \fBAM_STR\fR    \fBLC_TIME\fR   ante-meridiem affix
  43 _
  44 \fBPM_STR\fR    \fBLC_TIME\fR   post-meridiem affix
  45 _
  46 \fBDAY_1\fR     \fBLC_TIME\fR   T{
  47 name of the first day of the week (for example, Sunday)
  48 T}
  49 _
  50 \fBDAY_2\fR     \fBLC_TIME\fR   T{
  51 name of the second day of the week (for example, Monday)
  52 T}
  53 _
  54 \fBDAY_3\fR     \fBLC_TIME\fR   T{
  55 name of the third day of the week (for example, Tuesday)
  56 T}
  57 _
  58 \fBDAY_4\fR     \fBLC_TIME\fR   T{
  59 name of the fourth day of the week (for example, Wednesday)
  60 T}
  61 _
  62 \fBDAY_5\fR     \fBLC_TIME\fR   T{
  63 name of the fifth day of the week (for example, Thursday)
  64 T}
  65 _
  66 \fBDAY_6\fR     \fBLC_TIME\fR   T{
  67 name of the sixth day of the week (for example, Friday)
  68 T}
  69 _
  70 \fBDAY_7\fR     \fBLC_TIME\fR   T{
  71 name of the seventh day of the week (for example, Saturday)
  72 T}
  73 _
  74 \fBABDAY_1\fR   \fBLC_TIME\fR   T{
  75 abbreviated name of the first day of the week
  76 T}
  77 _
  78 \fBABDAY_2\fR   \fBLC_TIME\fR   T{
  79 abbreviated name of the second day of the week
  80 T}
  81 _
  82 \fBABDAY_3\fR   \fBLC_TIME\fR   T{
  83 abbreviated name of the third day of the week
  84 T}
  85 _
  86 \fBABDAY_4\fR   \fBLC_TIME\fR   T{
  87 abbreviated name of the fourth day of the week
  88 T}
  89 _
  90 \fBABDAY_5\fR   \fBLC_TIME\fR   T{
  91 abbreviated name of the fifth day of the week
  92 T}
  93 _
  94 \fBABDAY_6\fR   \fBLC_TIME\fR   T{
  95 abbreviated name of the seventh day of the week
  96 T}
  97 _
  98 \fBABDAY_7\fR   \fBLC_TIME\fR   T{
  99 abbreviated name of the seventh day of the week
 100 T}
 101 _
 102 \fBMON_1\fR     \fBLC_TIME\fR   name of the first month of the year
 103 _
 104 \fBMON_2\fR     \fBLC_TIME\fR   name of the second month
 105 _
 106 \fBMON_3\fR     \fBLC_TIME\fR   name of the third month
 107 _
 108 \fBMON_4\fR     \fBLC_TIME\fR   name of the fourth month
 109 _
 110 \fBMON_5\fR     \fBLC_TIME\fR   name of the fifth month
 111 _
 112 \fBMON_6\fR     \fBLC_TIME\fR   name of the sixth month
 113 _
 114 \fBMON_7\fR     \fBLC_TIME\fR   name of the seventh month
 115 _
 116 \fBMON_8\fR     \fBLC_TIME\fR   name of the eighth month
 117 _
 118 \fBMON_9\fR     \fBLC_TIME\fR   name of the ninth month
 119 _
 120 \fBMON_10\fR    \fBLC_TIME\fR   name of the tenth month
 121 _
 122 \fBMON_11\fR    \fBLC_TIME\fR   name of the eleventh month
 123 _
 124 \fBMON_12\fR    \fBLC_TIME\fR   name of the twelfth month
 125 _
 126 \fBABMON_1\fR   \fBLC_TIME\fR   abbreviated name of the first month
 127 _
 128 \fBABMON_2\fR   \fBLC_TIME\fR   abbreviated name of the second month
 129 _
 130 \fBABMON_3\fR   \fBLC_TIME\fR   abbreviated name of the third month
 131 _
 132 \fBABMON_4\fR   \fBLC_TIME\fR   abbreviated name of the fourth month
 133 _
 134 \fBABMON_5\fR   \fBLC_TIME\fR   abbreviated name of the fifth month
 135 _
 136 \fBABMON_6\fR   \fBLC_TIME\fR   abbreviated name of the sixth month
 137 _
 138 \fBABMON_7\fR   \fBLC_TIME\fR   abbreviated name of the seventh month
 139 _
 140 \fBABMON_8\fR   \fBLC_TIME\fR   abbreviated name of the eighth month
 141 _
 142 \fBABMON_9\fR   \fBLC_TIME\fR   abbreviated name of the ninth month
 143 _
 144 \fBABMON_10\fR  \fBLC_TIME\fR   abbreviated name of the tenth month
 145 _
 146 \fBABMON_11\fR  \fBLC_TIME\fR   abbreviated name of the eleventh month
 147 _
 148 \fBABMON_12\fR  \fB LC_TIME\fR  abbreviated name of the twelfth month
 149 _
 150 \fBERA\fR       \fBLC_TIME\fR   era description segments
 151 _
 152 \fBERA_D_FMT\fR \fBLC_TIME\fR   era date format string
 153 _
 154 \fBERA_D_T_FMT\fR       \fBLC_TIME\fR   era date and time format string
 155 _
 156 \fBERA_T_FMT\fR \fBLC_TIME\fR   era time format string
 157 _
 158 \fBALT_DIGITS\fR        \fBLC_TIME\fR   alternative symbols for digits
 159 _
 160 \fBRADIXCHAR\fR \fBLC_NUMERIC\fR        radix character
 161 _
 162 \fBTHOUSEP\fR   \fBLC_NUMERIC\fR        separator for thousands
 163 _
 164 \fBYESEXPR\fR   \fBLC_MESSAGES\fR       affirmative response expression
 165 _
 166 \fBNOEXPR\fR    \fBLC_MESSAGES\fR       negative response expression
 167 _
 168 \fBYESSTR\fR    \fBLC_MESSAGES\fR       affirmative response for yes/no queries
 169 _
 170 \fBNOSTR\fR     \fBLC_MESSAGES\fR       negative response ro yes/no queries
 171 _
 172 \fBCRNCYSTR\fR  \fBLC_MONETARY\fR       T{
 173 local currency symbol, preceded by '-' if the symbol should appear before the
 174 value, '+' if the symbol should appear after the value, or '.' if the symbol
 175 should replace the radix character
 176 T}
 177 .TE
 178
 179 .sp
 180 .LP
 181 If the locale's values for \fBp_cs_precedes\fR and \fBn_cs_precedes\fR do not
 182 match, the value of \fBnl_langinfo(CRNCYSTR)\fR is unspecified.
 183 .sp
 184 .LP
 185 The <\fBlanginfo.h\fR> header declares the following as a function:
 186 .sp
 187 .in +2
 188 .nf
 189 char *nl_langinfo(nl_item);
 190 .fi
 191 .in -2
 192
 193 .sp
 194 .LP
 195 Inclusion of <\fBlanginfo.h\fR> header may also make visible all symbols from
 196 <\fBnl_types.h\fR>.
 197 .SH USAGE
 198 .LP
 199 Wherever possible, users are advised to use functions compatible with those in
 200 the ISO C standard to access items of \fBlanginfo\fR data. In particular, the
 201 \fBstrftime\fR(3C) function should be used to access date and time information
 202 defined in category \fBLC_TIME\fR. The \fBlocaleconv\fR(3C) function should be
 203 used to access information corresponding to \fBRADIXCHAR\fR, \fBTHOUSEP\fR, and
 204 \fBCRNCYSTR\fR.
 205 .SH ATTRIBUTES
 206 .LP
 207 See \fBattributes\fR(5) for descriptions of the following attributes:
 208 .sp
 209
 210 .sp
 211 .TS
 212 box;
 213 c | c
 214 l | l .
 215 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 216 _
 217 Interface Stability     Standard
 218 .TE
 219
 220 .SH SEE ALSO
 221 .LP
 222 \fBmkmsgs\fR(1), \fBlocaleconv\fR(3C), \fBnl_langinfo\fR(3C),
 223 \fBnl_types.h\fR(3HEAD), \fBsetlocale\fR(3C), \fBstrftime\fR(3C),
 224 \fBattributes\fR(5), \fBstandards\fR(5)