NAME

       locale.h - category macros

SYNOPSIS

       #include <locale.h>

DESCRIPTION

       Some of the functionality described on this reference page extends the ISO C standard. Any
       conflict between the requirements described here and the ISO C standard is  unintentional.
       This volume of IEEE Std 1003.1-2001 defers to the ISO C standard.

       The  <locale.h> header shall provide a definition for lconv structure, which shall include
       at least the following members. (See the definitions of  LC_MONETARY  in  LC_MONETARY  and
       LC_NUMERIC .)

              char    *currency_symbol
              char    *decimal_point
              char     frac_digits
              char    *grouping
              char    *int_curr_symbol
              char     int_frac_digits
              char     int_n_cs_precedes
              char     int_n_sep_by_space
              char     int_n_sign_posn
              char     int_p_cs_precedes
              char     int_p_sep_by_space
              char     int_p_sign_posn
              char    *mon_decimal_point
              char    *mon_grouping
              char    *mon_thousands_sep
              char    *negative_sign
              char     n_cs_precedes
              char     n_sep_by_space
              char     n_sign_posn
              char    *positive_sign
              char     p_cs_precedes
              char     p_sep_by_space
              char     p_sign_posn
              char    *thousands_sep

       The  <locale.h>  header  shall  define  NULL  (as defined in <stddef.h> ) and at least the
       following as macros:

       LC_ALL
       LC_COLLATE
       LC_CTYPE

       LC_MESSAGES

       LC_MONETARY
       LC_NUMERIC
       LC_TIME

       which shall expand to distinct integer constant expressions, for use as the first argument
       to the setlocale() function.

       Additional  macro  definitions, beginning with the characters LC_ and an uppercase letter,
       may also be given here.

       The following shall be declared as functions and may also be defined as  macros.  Function
       prototypes shall be provided.

              struct  lconv *localeconv (void);
              char   *setlocale(int, const char *);

       The following sections are informative.

APPLICATION USAGE

       None.

RATIONALE

       None.

FUTURE DIRECTIONS

       None.

SEE ALSO

       The   System   Interfaces   volume  of  IEEE Std 1003.1-2001,  localeconv(),  setlocale(),
       Environment Variables

COPYRIGHT

       Portions of this text are reprinted and  reproduced  in  electronic  form  from  IEEE  Std
       1003.1,  2003  Edition,  Standard  for Information Technology -- Portable Operating System
       Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2003  by
       the  Institute  of  Electrical  and  Electronics Engineers, Inc and The Open Group. In the
       event of any discrepancy between this version and the original IEEE  and  The  Open  Group
       Standard,  the  original  IEEE  and  The  Open Group Standard is the referee document. The
       original Standard can be obtained online at http://www.opengroup.org/unix/online.html .