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 format 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), tm(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.