langinfo.h(3HEAD)                                                     Headers                                                    langinfo.h(3HEAD)

NAME

       langinfo.h, langinfo - language information constants

SYNOPSIS

       #include <langinfo.h>

DESCRIPTION

       The  <langinfo.h>  header  contains the constants used to identify items of langinfo data (see nl_langinfo(3C)).  The type of the constant,
       nl_item, is defined as described in <nl_types.h>.

       The following constants are defined. The entries under Category indicate in which setlocale(3C) category each item is defined.

       Constant         Category         Meaning
       CODESET          LC_CTYPE         codeset name
       D_T_FMT          LC_TIME          string for formatting date and time
       D_FMT            LC_TIME          date format string
       T_FMT            LC_TIME          time format string
       T_FMT_AMPM       LC_TIME          a.m. or p.m. time format string
       AM_STR           LC_TIME          ante-meridiem affix
       PM_STR           LC_TIME          post-meridiem affix
       DAY_1            LC_TIME          name of the first day of  the  week
                                         (for example, Sunday)
       DAY_2            LC_TIME          name  of the second day of the week
                                         (for example, Monday)
       DAY_3            LC_TIME          name of the third day of  the  week
                                         (for example, Tuesday)
       DAY_4            LC_TIME          name  of the fourth day of the week
                                         (for example, Wednesday)
       DAY_5            LC_TIME          name of the fifth day of  the  week
                                         (for example, Thursday)
       DAY_6            LC_TIME          name  of  the sixth day of the week
                                         (for example, Friday)
       DAY_7            LC_TIME          name of the seventh day of the week
                                         (for example, Saturday)
       ABDAY_1          LC_TIME          abbreviated  name  of the first day
                                         of the week
       ABDAY_2          LC_TIME          abbreviated name of the second  day
                                         of the week
       ABDAY_3          LC_TIME          abbreviated  name  of the third day
                                         of the week
       ABDAY_4          LC_TIME          abbreviated name of the fourth  day
                                         of the week
       ABDAY_5          LC_TIME          abbreviated  name  of the fifth day
                                         of the week
       ABDAY_6          LC_TIME          abbreviated name of the seventh day
                                         of the week
       ABDAY_7          LC_TIME          abbreviated name of the seventh day
                                         of the week
       MON_1            LC_TIME          name of the first month of the year
       MON_2            LC_TIME          name of the second month
       MON_3            LC_TIME          name of the third month
       MON_4            LC_TIME          name of the fourth month
       MON_5            LC_TIME          name of the fifth month
       MON_6            LC_TIME          name of the sixth month
       MON_7            LC_TIME          name of the seventh month
       MON_8            LC_TIME          name of the eighth month
       MON_9            LC_TIME          name of the ninth month
       MON_10           LC_TIME          name of the tenth month
       MON_11           LC_TIME          name of the eleventh month
       MON_12           LC_TIME          name of the twelfth month

       ABMON_1          LC_TIME          abbreviated name of the first month
       ABMON_2          LC_TIME          abbreviated  name  of  the   second
                                         month
       ABMON_3          LC_TIME          abbreviated name of the third month
       ABMON_4          LC_TIME          abbreviated   name  of  the  fourth
                                         month
       ABMON_5          LC_TIME          abbreviated name of the fifth month
       ABMON_6          LC_TIME          abbreviated name of the sixth month
       ABMON_7          LC_TIME          abbreviated  name  of  the  seventh
                                         month
       ABMON_8          LC_TIME          abbreviated   name  of  the  eighth
                                         month
       ABMON_9          LC_TIME          abbreviated name of the ninth month
       ABMON_10         LC_TIME          abbreviated name of the tenth month
       ABMON_11         LC_TIME          abbreviated name  of  the  eleventh
                                         month
       ABMON_12          LC_TIME         abbreviated  name  of  the  twelfth
                                         month
       ERA              LC_TIME          era description segments
       ERA_D_FMT        LC_TIME          era date format string
       ERA_D_T_FMT      LC_TIME          era date and time format string
       ERA_T_FMT        LC_TIME          era time format string
       ALT_DIGITS       LC_TIME          alternative symbols for digits
       RADIXCHAR        LC_NUMERIC       radix character
       THOUSEP          LC_NUMERIC       separator for thousands
       YESEXPR          LC_MESSAGES      affirmative response expression
       NOEXPR           LC_MESSAGES      negative response expression
       YESSTR           LC_MESSAGES      affirmative  response  for   yes/no
                                         queries
       NOSTR            LC_MESSAGES      negative response ro yes/no queries
       CRNCYSTR         LC_MONETARY      local  currency symbol, preceded by
                                         '-'  if  the  symbol  sould  appear
                                         before the value, '+' if the symbol
                                         should appear after the  value,  or
                                         '.'  if  the  symbol should replace
                                         the radix character

       If the locale's values for p_cs_precedes and n_cs_precedes do not match, the value of nl_langinfo(CRNCYSTR) is unspecified.

       The <langinfo.h> header declares the following as a function:

       char *nl_langinfo(nl_item);

       Inclusion of <langinfo.h> header may also make visible all symbols from <nl_types.h>.

USAGE

       Wherever possible, users are advised to use functions compatible with those in the ISO C standard to access items of langinfo data. In par-
       ticular, the strftime(3C) function should be used to access date and time information defined in category LC_TIME. The localeconv(3C) func-
       tion should be used to access information corresponding to RADIXCHAR, THOUSEP, and CRNCYSTR.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE         |      ATTRIBUTE VALUE        |
       +-----------------------------+-----------------------------+
       |Interface Stability          |Standard                     |
       +-----------------------------+-----------------------------+

SEE ALSO

       mkmsgs(1), localeconv(3C), nl_langinfo(3C), nl_types.h(3HEAD), setlocale(3C), strftime(3C), attributes(5), standards(5)

SunOS 5.10                                                          30 Aug 2002                                                  langinfo.h(3HEAD)