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

locale.h.0p (4600B)

    

  1. '\" et
  2. .TH locale.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. locale.h
  12. \(em category macros
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. #include <locale.h>
  17. .fi
  18. .SH DESCRIPTION
  19. Some of the functionality described on this reference page extends the
  20. ISO\ C standard. Applications shall define the appropriate feature test macro
  21. (see the System Interfaces volume of POSIX.1\(hy2017,
  22. .IR "Section 2.2" ", " "The Compilation Environment")
  23. to enable the visibility of these symbols in this header.
  24. .P
  25. The
  26. .IR <locale.h> 
  27. header shall define the
  28. .BR lconv
  29. structure, which shall include at least the following members.
  30. (See the definitions of
  31. .IR LC_MONETARY
  32. in
  33. .IR "Section 7.3.3" ", " "LC_MONETARY"
  34. and
  35. .IR "Section 7.3.4" ", " "LC_NUMERIC".)
  36. .sp
  37. .RS 4
  38. .nf
  40. char    *currency_symbol
  41. char    *decimal_point
  42. char     frac_digits
  43. char    *grouping
  44. char    *int_curr_symbol
  45. char     int_frac_digits
  46. char     int_n_cs_precedes
  47. char     int_n_sep_by_space
  48. char     int_n_sign_posn
  49. char     int_p_cs_precedes
  50. char     int_p_sep_by_space
  51. char     int_p_sign_posn
  52. char    *mon_decimal_point
  53. char    *mon_grouping
  54. char    *mon_thousands_sep
  55. char    *negative_sign
  56. char     n_cs_precedes
  57. char     n_sep_by_space
  58. char     n_sign_posn
  59. char    *positive_sign
  60. char     p_cs_precedes
  61. char     p_sep_by_space
  62. char     p_sign_posn
  63. char    *thousands_sep
  64. .fi
  65. .P
  66. .RE
  67. .P
  68. The
  69. .IR <locale.h> 
  70. header shall define NULL (as described in
  71. .IR <stddef.h> )
  72. and at least the following as macros:
  73. .P
  74. .nf
  75. LC_ALL
  76. LC_COLLATE
  77. LC_CTYPE
  78. LC_MESSAGES
  79. LC_MONETARY
  80. LC_NUMERIC
  81. LC_TIME
  82. .fi
  83. .P
  84. which shall expand to integer constant expressions with distinct
  85. values for use as the first argument to the
  86. \fIsetlocale\fR()
  87. function.
  88. .P
  89. Additional macro definitions, beginning with the characters
  90. .IR LC_
  91. and an uppercase letter, may also be specified by the implementation.
  92. .P
  93. The
  94. .IR <locale.h> 
  95. header shall contain at least the following macros representing
  96. bitmasks for use with the
  97. \fInewlocale\fR()
  98. function for each supported locale category:
  99. LC_COLLATE_MASK
  100. LC_CTYPE_MASK
  101. LC_MESSAGES_MASK
  102. LC_MONETARY_MASK
  103. LC_NUMERIC_MASK
  104. LC_TIME_MASK
  105. .P
  106. In addition, a macro to set the bits for all categories set shall be
  107. defined:
  108. LC_ALL_MASK
  109. .P
  110. The
  111. .IR <locale.h> 
  112. header shall define LC_GLOBAL_LOCALE, a special locale object descriptor
  113. used by the
  114. \fIduplocale\fR()
  115. and
  116. \fIuselocale\fR()
  117. functions.
  118. .P
  119. The
  120. .IR <locale.h> 
  121. header shall define the
  122. .BR locale_t
  123. type, representing a locale object.
  124. .P
  125. The following shall be declared as functions and may also be defined as
  126. macros. Function prototypes shall be provided for use with ISO\ C standard
  127. compilers.
  128. .sp
  129. .RS 4
  130. .nf
  132. locale_t      duplocale(locale_t);
  133. void          freelocale(locale_t);
  134. struct lconv *localeconv(void);
  135. locale_t      newlocale(int, const char *, locale_t);
  136. char         *setlocale(int, const char *);
  137. locale_t      uselocale (locale_t);
  138. .fi
  139. .P
  140. .RE
  141. .LP
  142. .IR "The following sections are informative."
  143. .SH "APPLICATION USAGE"
  144. None.
  145. .SH RATIONALE
  146. It is suggested that each category macro name for use in
  147. \fIsetlocale\fR()
  148. have a corresponding macro name ending in
  149. .IR _MASK
  150. for use in
  151. \fInewlocale\fR().
  152. .SH "FUTURE DIRECTIONS"
  153. None.
  154. .SH "SEE ALSO"
  155. .IR "Chapter 8" ", " "Environment Variables",
  156. .IR "\fB<stddef.h>\fP"
  157. .P
  158. The System Interfaces volume of POSIX.1\(hy2017,
  159. .IR "\fIduplocale\fR\^(\|)",
  160. .IR "\fIfreelocale\fR\^(\|)",
  161. .IR "\fIlocaleconv\fR\^(\|)",
  162. .IR "\fInewlocale\fR\^(\|)",
  163. .IR "\fIsetlocale\fR\^(\|)",
  164. .IR "\fIuselocale\fR\^(\|)"
  165. .\"
  166. .SH COPYRIGHT
  167. Portions of this text are reprinted and reproduced in electronic form
  168. from IEEE Std 1003.1-2017, Standard for Information Technology
  169. -- Portable Operating System Interface (POSIX), The Open Group Base
  170. Specifications Issue 7, 2018 Edition,
  171. Copyright (C) 2018 by the Institute of
  172. Electrical and Electronics Engineers, Inc and The Open Group.
  173. In the event of any discrepancy between this version and the original IEEE and
  174. The Open Group Standard, the original IEEE and The Open Group Standard
  175. is the referee document. The original Standard can be obtained online at
  176. http://www.opengroup.org/unix/online.html .
  177. .PP
  178. Any typographical or formatting errors that appear
  179. in this page are most likely
  180. to have been introduced during the conversion of the source files to
  181. man page format. To report such errors, see
  182. https://www.kernel.org/doc/man-pages/reporting_bugs.html .