1langinfo.h(3HEAD) Headers langinfo.h(3HEAD)
2
3
4
6 langinfo.h, langinfo - language information constants
7
9 #include <langinfo.h>
10
11
13 The <langinfo.h> header contains the constants used to identify items
14 of langinfo data (see nl_langinfo(3C)). The type of the constant,
15 nl_item, is defined as described in <nl_types.h>.
16
17
18 The following constants are defined. The entries under Category indi‐
19 cate in which setlocale(3C) category each item is defined.
20
21
22
23 │ │
24 Constant │ Category │ Meaning
25 ────────────────┼────────────────┼────────────────────────────────────────
26 CODESET │LC_CTYPE │codeset name
27 ────────────────┼────────────────┼────────────────────────────────────────
28 D_T_FMT │LC_TIME │string for formatting date and time
29 ────────────────┼────────────────┼────────────────────────────────────────
30 D_FMT │LC_TIME │date format string
31 ────────────────┼────────────────┼────────────────────────────────────────
32 T_FMT │LC_TIME │time format string
33 ────────────────┼────────────────┼────────────────────────────────────────
34 T_FMT_AMPM │LC_TIME │a.m. or p.m. time format string
35 ────────────────┼────────────────┼────────────────────────────────────────
36 AM_STR │LC_TIME │ante-meridiem affix
37 ────────────────┼────────────────┼────────────────────────────────────────
38 PM_STR │LC_TIME │post-meridiem affix
39 ────────────────┼────────────────┼────────────────────────────────────────
40 DAY_1 │LC_TIME │name of the first day of the week (for
41 │ │example, Sunday)
42 ────────────────┼────────────────┼────────────────────────────────────────
43 DAY_2 │LC_TIME │name of the second day of the week (for
44 │ │example, Monday)
45 ────────────────┼────────────────┼────────────────────────────────────────
46 DAY_3 │LC_TIME │name of the third day of the week (for
47 │ │example, Tuesday)
48 ────────────────┼────────────────┼────────────────────────────────────────
49 DAY_4 │LC_TIME │name of the fourth day of the week (for
50 │ │example, Wednesday)
51 ────────────────┼────────────────┼────────────────────────────────────────
52 DAY_5 │LC_TIME │name of the fifth day of the week (for
53 │ │example, Thursday)
54 ────────────────┼────────────────┼────────────────────────────────────────
55 DAY_6 │LC_TIME │name of the sixth day of the week (for
56 │ │example, Friday)
57 ────────────────┼────────────────┼────────────────────────────────────────
58 DAY_7 │LC_TIME │name of the seventh day of the week
59 │ │(for example, Saturday)
60 ────────────────┼────────────────┼────────────────────────────────────────
61 ABDAY_1 │LC_TIME │abbreviated name of the first day of
62 │ │the week
63 ────────────────┴────────────────┴────────────────────────────────────────
64
65
66
67 ABDAY_2 │LC_TIME │abbreviated name of the second day of
68 │ │the week
69 ────────────────┼────────────────┼────────────────────────────────────────
70 ABDAY_3 │LC_TIME │abbreviated name of the third day of
71 │ │the week
72 ────────────────┼────────────────┼────────────────────────────────────────
73 ABDAY_4 │LC_TIME │abbreviated name of the fourth day of
74 │ │the week
75 ────────────────┼────────────────┼────────────────────────────────────────
76 ABDAY_5 │LC_TIME │abbreviated name of the fifth day of
77 │ │the week
78 ────────────────┼────────────────┼────────────────────────────────────────
79 ABDAY_6 │LC_TIME │abbreviated name of the seventh day of
80 │ │the week
81 ────────────────┼────────────────┼────────────────────────────────────────
82 ABDAY_7 │LC_TIME │abbreviated name of the seventh day of
83 │ │the week
84 ────────────────┼────────────────┼────────────────────────────────────────
85 MON_1 │LC_TIME │name of the first month of the year
86 ────────────────┼────────────────┼────────────────────────────────────────
87 MON_2 │LC_TIME │name of the second month
88 ────────────────┼────────────────┼────────────────────────────────────────
89 MON_3 │LC_TIME │name of the third month
90 ────────────────┼────────────────┼────────────────────────────────────────
91 MON_4 │LC_TIME │name of the fourth month
92 ────────────────┼────────────────┼────────────────────────────────────────
93 MON_5 │LC_TIME │name of the fifth month
94 ────────────────┼────────────────┼────────────────────────────────────────
95 MON_6 │LC_TIME │name of the sixth month
96 ────────────────┼────────────────┼────────────────────────────────────────
97 MON_7 │LC_TIME │name of the seventh month
98 ────────────────┼────────────────┼────────────────────────────────────────
99 MON_8 │LC_TIME │name of the eighth month
100 ────────────────┼────────────────┼────────────────────────────────────────
101 MON_9 │LC_TIME │name of the ninth month
102 ────────────────┼────────────────┼────────────────────────────────────────
103 MON_10 │LC_TIME │name of the tenth month
104 ────────────────┼────────────────┼────────────────────────────────────────
105 MON_11 │LC_TIME │name of the eleventh month
106 ────────────────┼────────────────┼────────────────────────────────────────
107 MON_12 │LC_TIME │name of the twelfth month
108 ────────────────┼────────────────┼────────────────────────────────────────
109 ABMON_1 │LC_TIME │abbreviated name of the first month
110 ────────────────┼────────────────┼────────────────────────────────────────
111 ABMON_2 │LC_TIME │abbreviated name of the second month
112 ────────────────┼────────────────┼────────────────────────────────────────
113 ABMON_3 │LC_TIME │abbreviated name of the third month
114 ────────────────┼────────────────┼────────────────────────────────────────
115 ABMON_4 │LC_TIME │abbreviated name of the fourth month
116 ────────────────┼────────────────┼────────────────────────────────────────
117 ABMON_5 │LC_TIME │abbreviated name of the fifth month
118 ────────────────┼────────────────┼────────────────────────────────────────
119 ABMON_6 │LC_TIME │abbreviated name of the sixth month
120 ────────────────┼────────────────┼────────────────────────────────────────
121 ABMON_7 │LC_TIME │abbreviated name of the seventh month
122 ────────────────┼────────────────┼────────────────────────────────────────
123 ABMON_8 │LC_TIME │abbreviated name of the eighth month
124 ────────────────┼────────────────┼────────────────────────────────────────
125 ABMON_9 │LC_TIME │abbreviated name of the ninth month
126 ────────────────┼────────────────┼────────────────────────────────────────
127 ABMON_10 │LC_TIME │abbreviated name of the tenth month
128 ────────────────┼────────────────┼────────────────────────────────────────
129 ABMON_11 │LC_TIME │abbreviated name of the eleventh month
130 ────────────────┴────────────────┴────────────────────────────────────────
131
132
133 ABMON_12 │ LC_TIME │abbreviated name of the twelfth month
134 ────────────────┼────────────────┼────────────────────────────────────────
135 ERA │LC_TIME │era description segments
136 ────────────────┼────────────────┼────────────────────────────────────────
137 ERA_D_FMT │LC_TIME │era date format string
138 ────────────────┼────────────────┼────────────────────────────────────────
139 ERA_D_T_FMT │LC_TIME │era date and time format string
140 ────────────────┼────────────────┼────────────────────────────────────────
141 ERA_T_FMT │LC_TIME │era time format string
142 ────────────────┼────────────────┼────────────────────────────────────────
143 ALT_DIGITS │LC_TIME │alternative symbols for digits
144 ────────────────┼────────────────┼────────────────────────────────────────
145 RADIXCHAR │LC_NUMERIC │radix character
146 ────────────────┼────────────────┼────────────────────────────────────────
147 THOUSEP │LC_NUMERIC │separator for thousands
148 ────────────────┼────────────────┼────────────────────────────────────────
149 YESEXPR │LC_MESSAGES │affirmative response expression
150 ────────────────┼────────────────┼────────────────────────────────────────
151 NOEXPR │LC_MESSAGES │negative response expression
152 ────────────────┼────────────────┼────────────────────────────────────────
153 YESSTR │LC_MESSAGES │affirmative response for yes/no queries
154 ────────────────┼────────────────┼────────────────────────────────────────
155 NOSTR │LC_MESSAGES │negative response ro yes/no queries
156 ────────────────┼────────────────┼────────────────────────────────────────
157 CRNCYSTR │LC_MONETARY │local currency symbol, preceded by '-'
158 │ │if the symbol sould appear before the
159 │ │value, '+' if the symbol should appear
160 │ │after the value, or '.' if the symbol
161 │ │should replace the radix character
162
163
164
165 If the locale's values for p_cs_precedes and n_cs_precedes do not
166 match, the value of nl_langinfo(CRNCYSTR) is unspecified.
167
168
169 The <langinfo.h> header declares the following as a function:
170
171 char *nl_langinfo(nl_item);
172
173
174
175 Inclusion of <langinfo.h> header may also make visible all symbols from
176 <nl_types.h>.
177
179 Wherever possible, users are advised to use functions compatible with
180 those in the ISO C standard to access items of langinfo data. In par‐
181 ticular, the strftime(3C) function should be used to access date and
182 time information defined in category LC_TIME. The localeconv(3C) func‐
183 tion should be used to access information corresponding to RADIXCHAR,
184 THOUSEP, and CRNCYSTR.
185
187 See attributes(5) for descriptions of the following attributes:
188
189
190
191
192 ┌─────────────────────────────┬─────────────────────────────┐
193 │ ATTRIBUTE TYPE │ ATTRIBUTE VALUE │
194 ├─────────────────────────────┼─────────────────────────────┤
195 │Interface Stability │Standard │
196 └─────────────────────────────┴─────────────────────────────┘
197
199 mkmsgs(1), localeconv(3C), nl_langinfo(3C), nl_types.h(3HEAD), setlo‐
200 cale(3C), strftime(3C), attributes(5), standards(5)
201
202
203
204SunOS 5.11 30 Aug 2002 langinfo.h(3HEAD)