[BACK]Return to nl_langinfo.3 CVS log [TXT][DIR] Up to [cvs.NetBSD.org] / src / lib / libc / locale

File: [cvs.NetBSD.org] / src / lib / libc / locale / nl_langinfo.3 (download)

Revision 1.20, Thu Apr 14 05:50:49 2011 UTC (12 years, 11 months ago) by jruoho
Branch: MAIN
CVS Tags: yamt-pagecache-tag8, yamt-pagecache-base9, yamt-pagecache-base8, yamt-pagecache-base7, yamt-pagecache-base6, yamt-pagecache-base5, yamt-pagecache-base4, yamt-pagecache-base3, yamt-pagecache-base2, yamt-pagecache-base, yamt-pagecache, tls-maxphys-base, tls-maxphys, tls-earlyentropy-base, tls-earlyentropy, riastradh-xf86-video-intel-2-7-1-pre-2-21-15, riastradh-drm2-base3, riastradh-drm2-base2, riastradh-drm2-base1, riastradh-drm2-base, riastradh-drm2, prg-localcount2-base3, prg-localcount2-base2, prg-localcount2-base1, prg-localcount2-base, prg-localcount2, pgoyette-localcount-base, pgoyette-localcount-20170426, pgoyette-localcount-20170320, pgoyette-localcount-20170107, pgoyette-localcount-20161104, pgoyette-localcount-20160806, pgoyette-localcount-20160726, pgoyette-localcount, netbsd-8-base, netbsd-8-2-RELEASE, netbsd-8-1-RELEASE, netbsd-8-1-RC1, netbsd-8-0-RELEASE, netbsd-8-0-RC2, netbsd-8-0-RC1, netbsd-8, netbsd-7-nhusb-base-20170116, netbsd-7-nhusb-base, netbsd-7-nhusb, netbsd-7-base, netbsd-7-2-RELEASE, netbsd-7-1-RELEASE, netbsd-7-1-RC2, netbsd-7-1-RC1, netbsd-7-1-2-RELEASE, netbsd-7-1-1-RELEASE, netbsd-7-1, netbsd-7-0-RELEASE, netbsd-7-0-RC3, netbsd-7-0-RC2, netbsd-7-0-RC1, netbsd-7-0-2-RELEASE, netbsd-7-0-1-RELEASE, netbsd-7-0, netbsd-7, netbsd-6-base, netbsd-6-1-RELEASE, netbsd-6-1-RC4, netbsd-6-1-RC3, netbsd-6-1-RC2, netbsd-6-1-RC1, netbsd-6-1-5-RELEASE, netbsd-6-1-4-RELEASE, netbsd-6-1-3-RELEASE, netbsd-6-1-2-RELEASE, netbsd-6-1-1-RELEASE, netbsd-6-1, netbsd-6-0-RELEASE, netbsd-6-0-RC2, netbsd-6-0-RC1, netbsd-6-0-6-RELEASE, netbsd-6-0-5-RELEASE, netbsd-6-0-4-RELEASE, netbsd-6-0-3-RELEASE, netbsd-6-0-2-RELEASE, netbsd-6-0-1-RELEASE, netbsd-6-0, netbsd-6, matt-nb8-mediatek-base, matt-nb8-mediatek, matt-nb6-plus-nbase, matt-nb6-plus-base, matt-nb6-plus, localcount-20160914, cherry-xenmp-base, cherry-xenmp, bouyer-socketcan-base1, bouyer-socketcan-base, bouyer-socketcan, agc-symver-base, agc-symver
Changes since 1.19: +3 -2 lines

Xref tm(3).

.\"	$NetBSD: nl_langinfo.3,v 1.20 2011/04/14 05:50:49 jruoho Exp $
.\"
.\" Written by J.T. Conklin <jtc@NetBSD.org>.
.\" Public domain.
.\"
.Dd April 14, 2011
.Dt NL_LANGINFO 3
.Os
.Sh NAME
.Nm nl_langinfo
.Nd get locale information
.Sh LIBRARY
.Lb libc
.Sh SYNOPSIS
.In langinfo.h
.Ft char *
.Fn nl_langinfo "nl_item item"
.Sh DESCRIPTION
The
.Fn nl_langinfo
function returns a pointer to a string containing information
set by the program's locale.
.Pp
The names and values of
.Fa item
are defined in
.In langinfo.h .
The entries under Category indicate in which
.Xr setlocale 3
category each item is defined.
.Bl -column ERA_D_T_FMT LC_MESSAGES
.It Sy Constant Ta Sy Category Ta Sy Meaning
.It CODESET	LC_CTYPE	Codeset name
.It D_T_FMT	LC_TIME	String for formatting date and time
.It D_FMT	LC_TIME	Date format string
.It T_FMT	LC_TIME	Time format string
.It T_FMT_AMPM	LC_TIME	A.M. or P.M. time format string
.It AM_STR	LC_TIME	Ante-meridiem affix
.It PM_STR	LC_TIME	Post-meridiem affix
.It DAY_1	LC_TIME	Name of the first day of the week (e.g.: Sunday)
.It DAY_2	LC_TIME	Name of the second day of the week (e.g.: Monday)
.It DAY_3	LC_TIME	Name of the third day of the week (e.g.: Tuesday)
.It DAY_4	LC_TIME	Name of the fourth day of the week (e.g.: Wednesday)
.It DAY_5	LC_TIME	Name of the fifth day of the week (e.g.: Thursday)
.It DAY_6	LC_TIME	Name of the sixth day of the week (e.g.: Friday)
.It DAY_7	LC_TIME	Name of the seventh day of the week (e.g.: Saturday)
.It ABDAY_1	LC_TIME	Abbreviated name of the first day of the week
.It ABDAY_2	LC_TIME	Abbreviated name of the second day of the week
.It ABDAY_3	LC_TIME	Abbreviated name of the third day of the week
.It ABDAY_4	LC_TIME	Abbreviated name of the fourth day of the week
.It ABDAY_5	LC_TIME	Abbreviated name of the fifth day of the week
.It ABDAY_6	LC_TIME	Abbreviated name of the sixth day of the week
.It ABDAY_7	LC_TIME	Abbreviated name of the seventh day of the week
.It MON_1	LC_TIME	Name of the first month of the year
.It MON_2	LC_TIME	Name of the second month
.It MON_3	LC_TIME	Name of the third month
.It MON_4	LC_TIME	Name of the fourth month
.It MON_5	LC_TIME	Name of the fifth month
.It MON_6	LC_TIME	Name of the sixth month
.It MON_7	LC_TIME	Name of the seventh month
.It MON_8	LC_TIME	Name of the eighth month
.It MON_9	LC_TIME	Name of the ninth month
.It MON_10	LC_TIME	Name of the tenth month
.It MON_11	LC_TIME	Name of the eleventh month
.It MON_12	LC_TIME	Name of the twelfth month
.It ABMON_1	LC_TIME	Abbreviated name of the first month
.It ABMON_2	LC_TIME	Abbreviated name of the second month
.It ABMON_3	LC_TIME	Abbreviated name of the third month
.It ABMON_4	LC_TIME	Abbreviated name of the fourth month
.It ABMON_5	LC_TIME	Abbreviated name of the fifth month
.It ABMON_6	LC_TIME	Abbreviated name of the sixth month
.It ABMON_7	LC_TIME	Abbreviated name of the seventh month
.It ABMON_8	LC_TIME	Abbreviated name of the eighth month
.It ABMON_9	LC_TIME	Abbreviated name of the ninth month
.It ABMON_10	LC_TIME	Abbreviated name of the tenth month
.It ABMON_11	LC_TIME	Abbreviated name of the eleventh month
.It ABMON_12	LC_TIME	Abbreviated name of the twelfth month
.It ERA	LC_TIME	Era description segments
.It ERA_D_FMT	LC_TIME	Era date format string
.It ERA_D_T_FMT	LC_TIME	Era date and time format string
.It ERA_T_FMT	LC_TIME	Era time format string
.It ALT_DIGITS	LC_TIME	Alternative symbols for digits
.It RADIXCHAR	LC_NUMERIC	Radix character
.It THOUSEP	LC_NUMERIC	Separator for thousands
.It YESEXPR	LC_MESSAGES	Affirmative response expression
.It NOEXPR	LC_MESSAGES	Negative response expression
.\".It CRNCYSTR	LC_MONETARY	Local currency symbol
.El
.Sh RETURN VALUES
.Fn nl_langinfo
returns a pointer to an empty string if
.Fa item
is invalid.
.Sh EXAMPLES
The following example uses
.Fn nl_langinfo
to obtain the date and time format for the current locale:
.Pp
.Bd -literal -offset indent
#include \*[Lt]time.h\*[Gt]
#include \*[Lt]langinfo.h\*[Gt]
#include \*[Lt]locale.h\*[Gt]

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

	t = time(NULL);
	tm = localtime(\*[Am]t);
	(void)setlocale(LC_ALL, "");
	ptr = nl_langinfo(D_T_FMT);
	strftime(datestring, sizeof(datestring), ptr, tm);
	printf("%s\en", datestring);
	return (0);
}
.Ed
.\" .Pp
.\" The following example uses
.\" .Fn nl_langinfo
.\" to obtain the setting of the currency symbol for the current locale:
.\" .Pp
.\" .Bd
.\" 	#include \*[Lt]langinfo.h\*[Gt]
.\" 	#include \*[Lt]locale.h\*[Gt]
.\" 	int main(void)
.\" 	{
.\" 		char *ptr;
.\" 		(void)setlocale(LC_ALL, "");
.\" 		ptr = nl_langinfo(CRNCYSTR);
.\" 		printf("%s", ptr);
.\" 	}
.\" .Ed
.Sh SEE ALSO
.Xr setlocale 3 ,
.Xr tm 3 ,
.Xr nls 7
.Sh STANDARDS
The
.Fn nl_langinfo
function conforms to
.St -p1003.1-2001 .
.Sh HISTORY
The
.Fn nl_langinfo
function appeared in
.Nx 1.0 .