NL_LANGINFO(3)          NetBSD Library Functions Manual         NL_LANGINFO(3)

NAME
     nl_langinfo -- get locale information

LIBRARY
     Standard C Library (libc, -lc)

SYNOPSIS
     #include <langinfo.h>

     char *
     nl_langinfo(nl_item item);

DESCRIPTION
     The nl_langinfo() function returns a pointer to a string containing
     information set by the program's locale.

     The names and values of item are defined in <langinfo.h>.  The entries
     under Category indicate in which setlocale(3) 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 (e.g.: Sunday)
     DAY_2       LC_TIME     Name of the second day of the week (e.g.: Monday)
     DAY_3       LC_TIME     Name of the third day of the week (e.g.: Tuesday)
     DAY_4       LC_TIME     Name of the fourth day of the week (e.g.: Wednesday)
     DAY_5       LC_TIME     Name of the fifth day of the week (e.g.: Thursday)
     DAY_6       LC_TIME     Name of the sixth day of the week (e.g.: Friday)
     DAY_7       LC_TIME     Name of the seventh day of the week (e.g.: 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 sixth 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

RETURN VALUES
     nl_langinfo() returns a pointer to an empty string if item is invalid.

EXAMPLES
     The following example uses nl_langinfo() to obtain the date and time for-
     mat for the current locale:

           #include <time.h>
           #include <langinfo.h>
           #include <locale.h>

           int main(void)
           {
                   char datestring[100];
                   struct tm *tm;
                   time_t t;
                   char *ptr;

                   t = time(NULL);
                   tm = localtime(&t);
                   (void)setlocale(LC_ALL, "");
                   ptr = nl_langinfo(D_T_FMT);
                   strftime(datestring, sizeof(datestring), ptr, tm);
                   printf("%s\n",datestring);
                   return (0);
           }

SEE ALSO
     setlocale(3), nls(7)

STANDARDS
     The nl_langinfo() function conforms to IEEE Std 1003.1-2001
     (``POSIX.1'').

HISTORY
     The nl_langinfo() function appeared in NetBSD 1.0.

NetBSD 5.0.1                   February 12, 2003                  NetBSD 5.0.1

You can also request any man page by name and (optionally) by section:

Command: 
Section: 
Architecture: 
Collection: 
 

Use the DEFAULT collection to view manual pages for third-party software.


©1994 Man-cgi 1.15, Panagiotis Christias <christia@softlab.ntua.gr>
©1996-2014 Modified for NetBSD by Kimmo Suominen