• Start
• Documentation
  • PostgreSQL
  • mnoGoSearch
  • Apache 2.4
  • FreeBSD handbook
  • FreeBSD Manual
  • FreeBSD Source
• Tools
• Search
• Protected Area

plain

FreeBSD manual

keyword 1 2 3 4 5 6 7 8 9 n l

download PDF document: nl_langinfo.3.pdf

NL_LANGINFO(3) FreeBSD Library Functions Manual NL_LANGINFO(3)
NAME nl_langinfo - language information
LIBRARY Standard C Library (libc, -lc)
SYNOPSIS #include <langinfo.h>
char * nl_langinfo(nl_item item);
char * nl_langinfo_l(nl_item item, locale_t loc);
DESCRIPTION The nl_langinfo() function returns a pointer to a string containing information relevant to the particular language or cultural area defined in the program or thread's locale, or in the case of nl_langinfo_l(), the locale passed as the second argument.
Calls to setlocale() with a category corresponding to the category of item, or to the category LC_ALL, may overwrite the buffer pointed to by the return value.
The manifest constant names and values of item are defined in <langinfo.h>.
The following standard constants are recognized:
Constant Category Description 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 DAY_2 LC_TIME name of the second day of the week DAY_3 LC_TIME name of the third day of the week DAY_4 LC_TIME name of the fourth day of the week DAY_5 LC_TIME name of the fifth day of the week DAY_6 LC_TIME name of the sixth day of the week DAY_7 LC_TIME name of the seventh day of the week 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 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 extended regular expression NOEXPR LC_MESSAGES negative response extended regular expression CRNCYSTR LC_MONETARY local currency symbol, preceded by '-' if the symbol should appear before the value, '+' if the symbol should appear after the value, or '.' if the symbol should replace the radix character; if the local currency symbol is the empty string, implementations may return the empty string ("")
The following non-standard FreeBSD extensions are recognized:
Constant Category Description D_MD_ORDER LC_TIME month/day order ALTMON_1 LC_TIME standalone name of the first month ALTMON_2 LC_TIME standalone name of the second month ALTMON_3 LC_TIME standalone name of the third month ALTMON_4 LC_TIME standalone name of the fourth month ALTMON_5 LC_TIME standalone name of the fifth month ALTMON_6 LC_TIME standalone name of the sixth month ALTMON_7 LC_TIME standalone name of the seventh month ALTMON_8 LC_TIME standalone name of the eighth month ALTMON_9 LC_TIME standalone name of the ninth month ALTMON_10 LC_TIME standalone name of the tenth month ALTMON_11 LC_TIME standalone name of the eleventh month ALTMON_12 LC_TIME standalone name of the twelfth month YESSTR LC_MESSAGES affirmative response string NOSTR LC_MESSAGES negative response string
RETURN VALUES In a locale where langinfo data is not defined, nl_langinfo() returns a pointer to the corresponding string in the POSIX locale. nl_langinfo_l() returns the same values as nl_langinfo(). In all locales, nl_langinfo() returns a pointer to an empty string if item contains an invalid setting.
EXAMPLES For example:
nl_langinfo(ABDAY_1)
would return a pointer to the string "Dom" if the identified language was Specification ("SUSv2"). The nl_langinfo_l() function conforms to IEEE Std 1003.1-2008 ("POSIX.1").
HISTORY The nl_langinfo() function first appeared in FreeBSD 4.6.
FreeBSD 14.0-RELEASE-p6 December 14, 2020 FreeBSD 14.0-RELEASE-p6