[apple/libc.git] / locale / querylocale.3

.Dd March 11, 2005
.Dt QUERYLOCALE 3
.Os
.Sh NAME
.Nm querylocale
.Nd Get locale name for a specified category
.Sh SYNOPSIS
.In xlocale.h
.Ft const char *
.Fn querylocale "int mask" "locale_t loc"
.Sh DESCRIPTION
Returns the name of the locale for the category specified by
.Va mask .
The
.Va mask
is scanned starting at the least significant bit,
until the first set bit is found. This happens
to scan the categories alphabetically, not 
including
.Dv LC_ALL_MASK ,
but it is best to specify one category at a time.
The available categories are documented in
.Xr xlocale 3
and
.Xr newlocale 3 .
.Sh SEE ALSO
.Xr duplocale 3 ,
.Xr freelocale 3 ,
.Xr newlocale 3 ,
.Xr uselocale 3 ,
.Xr xlocale 3
Commit	Line	Data
3d9156a7 A	1	.Dd March 11, 2005
	2	.Dt QUERYLOCALE 3
	3	.Os
	4	.Sh NAME
	5	.Nm querylocale
	6	.Nd Get locale name for a specified category
	7	.Sh SYNOPSIS
	8	.In xlocale.h
	9	.Ft const char *
	10	.Fn querylocale "int mask" "locale_t loc"
	11	.Sh DESCRIPTION
	12	Returns the name of the locale for the category specified by
	13	.Va mask .
	14	The
	15	.Va mask
	16	is scanned starting at the least significant bit,
	17	until the first set bit is found. This happens
	18	to scan the categories alphabetically, not
	19	including
	20	.Dv LC_ALL_MASK ,
	21	but it is best to specify one category at a time.
	22	The available categories are documented in
	23	.Xr xlocale 3
	24	and
	25	.Xr newlocale 3 .
	26	.Sh SEE ALSO
3d9156a7 A	27	.Xr duplocale 3 ,
	28	.Xr freelocale 3 ,
	29	.Xr newlocale 3 ,
224c7076 A	30	.Xr uselocale 3 ,
224c7076 A	31	.Xr xlocale 3