logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

langinfo.h.0p (6370B)


  1. '\" et
  2. .TH langinfo.h "0P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. langinfo.h
  12. \(em language information constants
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. #include <langinfo.h>
  17. .fi
  18. .SH DESCRIPTION
  19. The
  20. .IR <langinfo.h>
  21. header shall define the symbolic constants used to identify items of
  22. .IR langinfo
  23. data (see
  24. \fInl_langinfo\fR()).
  25. .P
  26. The
  27. .IR <langinfo.h>
  28. header shall define the
  29. .BR locale_t
  30. type as described in
  31. .IR <locale.h> .
  32. .P
  33. The
  34. .IR <langinfo.h>
  35. header shall define the
  36. .BR nl_item
  37. type as described in
  38. .IR <nl_types.h> .
  39. .P
  40. The
  41. .IR <langinfo.h>
  42. header shall define the following symbolic constants with type
  43. .BR nl_item .
  44. The entries under
  45. .BR Category
  46. indicate in which
  47. \fIsetlocale\fR()
  48. category each item is defined.
  49. .TS
  50. box center tab(!);
  51. cB | cB | cB
  52. l1 | lI1 | l.
  53. Constant!Category!Meaning
  54. _
  55. CODESET!LC_CTYPE!Codeset name.
  56. D_T_FMT!LC_TIME!String for formatting date and time.
  57. D_FMT!LC_TIME!Date format string.
  58. T_FMT!LC_TIME!Time format string.
  59. T_FMT_AMPM!LC_TIME!a.m. or p.m. time format string.
  60. AM_STR!LC_TIME!Ante-meridiem affix.
  61. PM_STR!LC_TIME!Post-meridiem affix.
  62. DAY_1!LC_TIME!Name of the first day of the week (for example, Sunday).
  63. DAY_2!LC_TIME!Name of the second day of the week (for example, Monday).
  64. DAY_3!LC_TIME!Name of the third day of the week (for example, Tuesday).
  65. DAY_4!LC_TIME!Name of the fourth day of the week
  66. !!(for example, Wednesday).
  67. DAY_5!LC_TIME!Name of the fifth day of the week (for example, Thursday).
  68. DAY_6!LC_TIME!Name of the sixth day of the week (for example, Friday).
  69. DAY_7!LC_TIME!Name of the seventh day of the week
  70. !!(for example, Saturday).
  71. ABDAY_1!LC_TIME!Abbreviated name of the first day of the week.
  72. ABDAY_2!LC_TIME!Abbreviated name of the second day of the week.
  73. ABDAY_3!LC_TIME!Abbreviated name of the third day of the week.
  74. ABDAY_4!LC_TIME!Abbreviated name of the fourth day of the week.
  75. ABDAY_5!LC_TIME!Abbreviated name of the fifth day of the week.
  76. ABDAY_6!LC_TIME!Abbreviated name of the sixth day of the week.
  77. ABDAY_7!LC_TIME!Abbreviated name of the seventh day of the week.
  78. MON_1!LC_TIME!Name of the first month of the year.
  79. MON_2!LC_TIME!Name of the second month.
  80. MON_3!LC_TIME!Name of the third month.
  81. MON_4!LC_TIME!Name of the fourth month.
  82. MON_5!LC_TIME!Name of the fifth month.
  83. MON_6!LC_TIME!Name of the sixth month.
  84. MON_7!LC_TIME!Name of the seventh month.
  85. MON_8!LC_TIME!Name of the eighth month.
  86. MON_9!LC_TIME!Name of the ninth month.
  87. MON_10!LC_TIME!Name of the tenth month.
  88. MON_11!LC_TIME!Name of the eleventh month.
  89. MON_12!LC_TIME!Name of the twelfth month.
  90. ABMON_1!LC_TIME!Abbreviated name of the first month.
  91. ABMON_2!LC_TIME!Abbreviated name of the second month.
  92. ABMON_3!LC_TIME!Abbreviated name of the third month.
  93. ABMON_4!LC_TIME!Abbreviated name of the fourth month.
  94. ABMON_5!LC_TIME!Abbreviated name of the fifth month.
  95. ABMON_6!LC_TIME!Abbreviated name of the sixth month.
  96. ABMON_7!LC_TIME!Abbreviated name of the seventh month.
  97. ABMON_8!LC_TIME!Abbreviated name of the eighth month.
  98. ABMON_9!LC_TIME!Abbreviated name of the ninth month.
  99. ABMON_10!LC_TIME!Abbreviated name of the tenth month.
  100. ABMON_11!LC_TIME!Abbreviated name of the eleventh month.
  101. ABMON_12!LC_TIME!Abbreviated name of the twelfth month.
  102. ERA!LC_TIME!Era description segments.
  103. ERA_D_FMT!LC_TIME!Era date format string.
  104. ERA_D_T_FMT!LC_TIME!Era date and time format string.
  105. ERA_T_FMT!LC_TIME!Era time format string.
  106. ALT_DIGITS!LC_TIME!Alternative symbols for digits.
  107. RADIXCHAR!LC_NUMERIC!Radix character.
  108. THOUSEP!LC_NUMERIC!Separator for thousands.
  109. YESEXPR!LC_MESSAGES!Affirmative response expression.
  110. NOEXPR!LC_MESSAGES!Negative response expression.
  111. CRNCYSTR!LC_MONETARY!T{
  112. Local currency symbol, preceded by
  113. .BR '\-'
  114. if the symbol should appear before the value,
  115. .BR '+'
  116. if the symbol should appear after the value, or
  117. .BR '.'
  118. if the symbol should replace the radix character. If the local
  119. currency symbol is the empty string, implementations may return
  120. the empty string (\c
  121. .BR \(dq\&\(dq ).
  122. T}
  123. .TE
  124. .P
  125. If the locale's values for
  126. .BR p_cs_precedes
  127. and
  128. .BR n_cs_precedes
  129. do not match, the value of
  130. .IR nl_langinfo (CRNCYSTR)
  131. and
  132. .IR nl_langinfo_l (CRNCYSTR,loc)
  133. is unspecified.
  134. .P
  135. The following shall be declared as a function and may also be defined
  136. as a macro. A function prototype shall be provided.
  137. .sp
  138. .RS 4
  139. .nf
  140. char *nl_langinfo(nl_item);
  141. char *nl_langinfo_l(nl_item, locale_t);
  142. .fi
  143. .P
  144. .RE
  145. .P
  146. Inclusion of the
  147. .IR <langinfo.h>
  148. header may also make visible all symbols from
  149. .IR <nl_types.h> .
  150. .LP
  151. .IR "The following sections are informative."
  152. .SH "APPLICATION USAGE"
  153. Wherever possible, users are advised to use functions compatible with
  154. those in the ISO\ C standard to access items of
  155. .IR langinfo
  156. data. In particular, the
  157. \fIstrftime\fR()
  158. function should be used to access date and time information defined in
  159. category
  160. .IR LC_TIME .
  161. The
  162. \fIlocaleconv\fR()
  163. function should be used to access information corresponding to
  164. RADIXCHAR, THOUSEP, and CRNCYSTR.
  165. .SH RATIONALE
  166. None.
  167. .SH "FUTURE DIRECTIONS"
  168. None.
  169. .SH "SEE ALSO"
  170. .IR "Chapter 7" ", " "Locale",
  171. .IR "\fB<locale.h>\fP",
  172. .IR "\fB<nl_types.h>\fP"
  173. .P
  174. The System Interfaces volume of POSIX.1\(hy2017,
  175. .IR "\fInl_langinfo\fR\^(\|)",
  176. .IR "\fIlocaleconv\fR\^(\|)",
  177. .IR "\fIstrfmon\fR\^(\|)",
  178. .IR "\fIstrftime\fR\^(\|)"
  179. .\"
  180. .SH COPYRIGHT
  181. Portions of this text are reprinted and reproduced in electronic form
  182. from IEEE Std 1003.1-2017, Standard for Information Technology
  183. -- Portable Operating System Interface (POSIX), The Open Group Base
  184. Specifications Issue 7, 2018 Edition,
  185. Copyright (C) 2018 by the Institute of
  186. Electrical and Electronics Engineers, Inc and The Open Group.
  187. In the event of any discrepancy between this version and the original IEEE and
  188. The Open Group Standard, the original IEEE and The Open Group Standard
  189. is the referee document. The original Standard can be obtained online at
  190. http://www.opengroup.org/unix/online.html .
  191. .PP
  192. Any typographical or formatting errors that appear
  193. in this page are most likely
  194. to have been introduced during the conversion of the source files to
  195. man page format. To report such errors, see
  196. https://www.kernel.org/doc/man-pages/reporting_bugs.html .