Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Thursday, June 13, 2019
 
 

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 <langinfo.h> header defines the locale_t type as described in <locale.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);
char *nl_langinfo_l(nl_item, locale_t);

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 particular, the strftime(3C) function should be used to access date and time information defined in category LC_TIME. The localeconv(3C) function should be used to access information corresponding to RADIXCHAR, THOUSEP, and CRNCYSTR.

Attributes

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

ATTRIBUTE TYPE
ATTRIBUTE VALUE
Interface Stability
Committed
Standard

See Also

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