xref: /freebsd/lib/libc/locale/querylocale.3 (revision 3c87aa1d3dc1d8dad3efad322852a8e1e76dee55)
1*3c87aa1dSDavid Chisnall.\" Copyright (c) 2011 The FreeBSD Foundation
2*3c87aa1dSDavid Chisnall.\" All rights reserved.
3*3c87aa1dSDavid Chisnall.\"
4*3c87aa1dSDavid Chisnall.\" This documentation was written by David Chisnall under sponsorship from
5*3c87aa1dSDavid Chisnall.\" the FreeBSD Foundation.
6*3c87aa1dSDavid Chisnall.\"
7*3c87aa1dSDavid Chisnall.\" Redistribution and use in source and binary forms, with or without
8*3c87aa1dSDavid Chisnall.\" modification, are permitted provided that the following conditions
9*3c87aa1dSDavid Chisnall.\" are met:
10*3c87aa1dSDavid Chisnall.\" 1. Redistributions of source code must retain the above copyright
11*3c87aa1dSDavid Chisnall.\"    notice, this list of conditions and the following disclaimer.
12*3c87aa1dSDavid Chisnall.\" 2. Redistributions in binary form must reproduce the above copyright
13*3c87aa1dSDavid Chisnall.\"    notice, this list of conditions and the following disclaimer in the
14*3c87aa1dSDavid Chisnall.\"    documentation and/or other materials provided with the distribution.
15*3c87aa1dSDavid Chisnall.\"
16*3c87aa1dSDavid Chisnall.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
17*3c87aa1dSDavid Chisnall.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
18*3c87aa1dSDavid Chisnall.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
19*3c87aa1dSDavid Chisnall.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
20*3c87aa1dSDavid Chisnall.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
21*3c87aa1dSDavid Chisnall.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
22*3c87aa1dSDavid Chisnall.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
23*3c87aa1dSDavid Chisnall.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
24*3c87aa1dSDavid Chisnall.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
25*3c87aa1dSDavid Chisnall.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
26*3c87aa1dSDavid Chisnall.\" SUCH DAMAGE.
27*3c87aa1dSDavid Chisnall.\"
28*3c87aa1dSDavid Chisnall.\" $FreeBSD$
29*3c87aa1dSDavid Chisnall.\"
30*3c87aa1dSDavid Chisnall.Dd September 17 2011
31*3c87aa1dSDavid Chisnall.Dt QUERYLOCALE 3
32*3c87aa1dSDavid Chisnall.Os
33*3c87aa1dSDavid Chisnall.Sh NAME
34*3c87aa1dSDavid Chisnall.Nm querylocale
35*3c87aa1dSDavid Chisnall.Nd Look up the locale name for a specified category.
36*3c87aa1dSDavid Chisnall.Sh LIBRARY
37*3c87aa1dSDavid Chisnall.Lb libc
38*3c87aa1dSDavid Chisnall.Sh SYNOPSIS
39*3c87aa1dSDavid Chisnall.In xlocale.h
40*3c87aa1dSDavid Chisnall.Ft const char *
41*3c87aa1dSDavid Chisnall.Fn querylocale "int mask" "locale_t locale"
42*3c87aa1dSDavid Chisnall.Sh DESCRIPTION
43*3c87aa1dSDavid ChisnallReturns the name of the locale for the category specified by
44*3c87aa1dSDavid Chisnall.Fa mask.
45*3c87aa1dSDavid ChisnallThis possible values for the mask are the same as those in
46*3c87aa1dSDavid Chisnall.Xr newlocale 3 .  If more than one bit in the mask is set, the returned value
47*3c87aa1dSDavid Chisnallis undefined.
48*3c87aa1dSDavid Chisnall.Sh SEE ALSO
49*3c87aa1dSDavid Chisnall.Xr duplocale 3 ,
50*3c87aa1dSDavid Chisnall.Xr freelocale 3 ,
51*3c87aa1dSDavid Chisnall.Xr localeconv 3 ,
52*3c87aa1dSDavid Chisnall.Xr newlocale 3 ,
53*3c87aa1dSDavid Chisnall.Xr uselocale 3 ,
54*3c87aa1dSDavid Chisnall.Xr xlocale 3
55*3c87aa1dSDavid Chisnall.Sh STANDARDS
56*3c87aa1dSDavid ChisnallThis function, conforms to
57*3c87aa1dSDavid Chisnall.St -p1003.1-2008
58