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

.Dd March 11, 2005
.Dt DUPLOCALE 3
.Os
.Sh NAME
.Nm duplocale
.Nd Duplicate existing locale
.Sh SYNOPSIS
.In xlocale.h
.Ft locale_t
.Fn duplocale "locale_t loc"
.Sh DESCRIPTION
Duplicates an existing
.Vt locale_t .
Sub-structures are shared between the two
.Vt locale_t
structures.
Passing
.Dv NULL
will duplicate the current locale.
Passing
.Dv LC_GLOBAL_LOCALE
will duplicate the global locale.
.Sh RETURN VALUES
Returns a duplicated
.Vt locale_t ,
or
.Dv NULL
on error.
Duplicated locales should be freed with
.Xr freelocale 3 .
.Sh SEE ALSO
.Xr freelocale 3 ,
.Xr newlocale 3 ,
.Xr querylocale 3 ,
.Xr uselocale 3 ,
.Xr xlocale 3
Commit	Line	Data
3d9156a7 A	1	.Dd March 11, 2005
	2	.Dt DUPLOCALE 3
	3	.Os
	4	.Sh NAME
	5	.Nm duplocale
	6	.Nd Duplicate existing locale
	7	.Sh SYNOPSIS
	8	.In xlocale.h
	9	.Ft locale_t
	10	.Fn duplocale "locale_t loc"
	11	.Sh DESCRIPTION
	12	Duplicates an existing
	13	.Vt locale_t .
	14	Sub-structures are shared between the two
	15	.Vt locale_t
	16	structures.
	17	Passing
	18	.Dv NULL
	19	will duplicate the current locale.
	20	Passing
	21	.Dv LC_GLOBAL_LOCALE
	22	will duplicate the global locale.
	23	.Sh RETURN VALUES
	24	Returns a duplicated
	25	.Vt locale_t ,
	26	or
	27	.Dv NULL
	28	on error.
	29	Duplicated locales should be freed with
	30	.Xr freelocale 3 .
	31	.Sh SEE ALSO
3d9156a7 A	32	.Xr freelocale 3 ,
	33	.Xr newlocale 3 ,
	34	.Xr querylocale 3 ,
224c7076 A	35	.Xr uselocale 3 ,
224c7076 A	36	.Xr xlocale 3