locale.h(0p)

1<locale.h>(0P)             POSIX Programmer's Manual            <locale.h>(0P)
2
3
4

NAME

6       locale.h - category macros
7

SYNOPSIS

9       #include <locale.h>
10

DESCRIPTION

12       Some  of the functionality described on this reference page extends the
13       ISO C standard. Any conflict between the  requirements  described  here
14       and   the   ISO C   standard   is   unintentional.    This   volume  of
15       IEEE Std 1003.1-2001 defers to the ISO C standard.
16
17       The <locale.h> header shall provide a definition for  lconv  structure,
18       which  shall  include  at least the following members. (See the defini‐
19       tions of LC_MONETARY in LC_MONETARY and LC_NUMERIC .)
20
21
22              char    *currency_symbol
23              char    *decimal_point
24              char     frac_digits
25              char    *grouping
26              char    *int_curr_symbol
27              char     int_frac_digits
28              char     int_n_cs_precedes
29              char     int_n_sep_by_space
30              char     int_n_sign_posn
31              char     int_p_cs_precedes
32              char     int_p_sep_by_space
33              char     int_p_sign_posn
34              char    *mon_decimal_point
35              char    *mon_grouping
36              char    *mon_thousands_sep
37              char    *negative_sign
38              char     n_cs_precedes
39              char     n_sep_by_space
40              char     n_sign_posn
41              char    *positive_sign
42              char     p_cs_precedes
43              char     p_sep_by_space
44              char     p_sign_posn
45              char    *thousands_sep
46
47       The <locale.h> header shall define NULL (as defined in <stddef.h> ) and
48       at least the following as macros:
49
50       LC_ALL
51       LC_COLLATE
52       LC_CTYPE
53
54       LC_MESSAGES
55
56       LC_MONETARY
57       LC_NUMERIC
58       LC_TIME
59
60       which shall expand to distinct integer constant expressions, for use as
61       the first argument to the setlocale() function.
62
63       Additional macro definitions, beginning with the characters LC_ and  an
64       uppercase letter, may also be given here.
65
66       The following shall be declared as functions and may also be defined as
67       macros. Function prototypes shall be provided.
68
69
70              struct  lconv *localeconv (void);
71              char   *setlocale(int, const char *);
72
73       The following sections are informative.
74

APPLICATION USAGE

76       None.
77

RATIONALE

79       None.
80

FUTURE DIRECTIONS

82       None.
83

COPYRIGHT

89       Portions  of  this text are reprinted and reproduced in electronic form
90       from IEEE Std 1003.1, 2003 Edition, Standard for Information Technology
91       --  Portable  Operating  System  Interface (POSIX), The Open Group Base
92       Specifications Issue 6, Copyright (C) 2001-2003  by  the  Institute  of
93       Electrical  and  Electronics  Engineers, Inc and The Open Group. In the
94       event of any discrepancy between this version and the original IEEE and
95       The  Open Group Standard, the original IEEE and The Open Group Standard
96       is the referee document. The original Standard can be  obtained  online
97       at http://www.opengroup.org/unix/online.html .
98
99
100
101IEEE/The Open Group                  2003                       <locale.h>(0P)