<!DOCTYPE html PUBLIC "‐//W3C//DTD XHTML 1.1//EN"
        "http://www.w3.org/TR/xhtml11/DTD/xhtml11.dtd">     <html
xmlns="http://www.w3.org/1999/xhtml"> <head>
    <link            rel="stylesheet"             type="text/css"
href="../../../style.css" title="style" />
    <link  rel="stylesheet"  type="text/css"  href="../style.css"
title="style" />
    <meta             http‐equiv="content‐type"              con‐
tent="text/html;charset=utf‐8" />

    <title>locale.h.0p ‐ Linux manual page</title> </head>

<body>

<div        class="page‐top"><a       id="top_of_page"></a></div>
<!‐‐%%%TOP_BAR%%%‐‐> <!‐‐%%%PAGE_START%%%‐‐>

<table class="sec‐table"> <tr>
    <td>
        <p class="section‐dir"> <a href="#PROLOG">PROLOG</a> | <a
href="#NAME">NAME</a>  |  <a  href="#SYNOPSIS">SYNOPSIS</a>  | <a
href="#DESCRIPTION">DESCRIPTION</a> |  <a  href="#APPLICATION_US‐
AGE">APPLICATION&nbsp;USAGE</a>   |  <a  href="#RATIONALE">RATIO‐
NALE</a>   |   <a    href="#FUTURE_DIRECTIONS">FUTURE&nbsp;DIREC‐
TIONS</a>    |   <a   href="#SEE_ALSO">SEE&nbsp;ALSO</a>   |   <a
href="#COPYRIGHT">COPYRIGHT</a>
        </p>
    </td>
    <td class="search‐box">
        <div class="man‐search‐box">

            <form                method="get"                 ac‐
tion="http://www.google.com/search">
                <fieldset class="man‐search">
                    <input    type="text"    name="q"   size="10"
maxlength="255" value="" />
                    <input type="hidden"  name="sitesearch"  val‐
ue="man7.org/linux/man‐pages" />
                    <input  type="submit" name="sa" value="Search
online pages" />
                </fieldset>
            </form>

        </div>
    </td>
    <td> </td> </tr> </table>

<pre> <span class="headline">locale.h(0P)              POSIX Pro‐
grammer’s  Manual              locale.h(0P)</span>  </pre> <h2><a
id="PROLOG" href="#PROLOG"></a>PROLOG  &nbsp; &nbsp; &nbsp;  &nb‐
sp;        <a        href="#top_of_page"><span        class="top‐
link">top</span></a></h2><pre>
       This manual page is part of the POSIX Programmer’s Manual.
The Linux
       implementation of this interface may differ (consult the
       corresponding  Linux  manual page for details of Linux be‐
havior), or
       the interface may not be  implemented  on  Linux.   </pre>
<h2><a id="NAME" href="#NAME"></a>NAME  &nbsp; &nbsp; &nbsp; &nb‐
sp;        <a        href="#top_of_page"><span        class="top‐
link">top</span></a></h2><pre>
       locale.h  —  category  macros  </pre> <h2><a id="SYNOPSIS"
href="#SYNOPSIS"></a>SYNOPSIS  &nbsp;  &nbsp;  &nbsp;  &nbsp;  <a
href="#top_of_page"><span                             class="top‐
link">top</span></a></h2><pre>
       #include &lt;locale.h&gt; </pre>  <h2><a  id="DESCRIPTION"
href="#DESCRIPTION"></a>DESCRIPTION   &nbsp; &nbsp; &nbsp; &nbsp;
<a             href="#top_of_page"><span              class="top‐
link">top</span></a></h2><pre>
       Some of the functionality described on this reference page
extends
       the ISO C standard. Applications shall define  the  appro‐
priate feature
       test   macro   (see   the   System  Interfaces  volume  of
POSIX.1‐2008, <i>Section</i>
       <i>2.2</i>, <i>The Compilation Environment</i>) to  enable
the visibility of these
       symbols in this header.

       The   <i>&lt;locale.h&gt;</i>   header  shall  define  the
<b>lconv </b>structure, which shall
       include at least the following members.  (See the  defini‐
tions of
       <i>LC_MONETARY</i>  in  <i>Section  7.3.3</i>, <i>LC_MONE‐
TARY</i> and <i>Section 7.3.4</i>,
       <i>LC_NUMERIC</i>.)

           <b>char    *currency_symbol</b>
           <b>char    *decimal_point</b>
           <b>char     frac_digits</b>
           <b>char    *grouping</b>
           <b>char    *int_curr_symbol</b>
           <b>char     int_frac_digits</b>
           <b>char     int_n_cs_precedes</b>
           <b>char     int_n_sep_by_space</b>
           <b>char     int_n_sign_posn</b>
           <b>char     int_p_cs_precedes</b>
           <b>char     int_p_sep_by_space</b>
           <b>char     int_p_sign_posn</b>
           <b>char    *mon_decimal_point</b>
           <b>char    *mon_grouping</b>
           <b>char    *mon_thousands_sep</b>
           <b>char    *negative_sign</b>
           <b>char     n_cs_precedes</b>
           <b>char     n_sep_by_space</b>
           <b>char     n_sign_posn</b>
           <b>char    *positive_sign</b>
           <b>char     p_cs_precedes</b>
           <b>char     p_sep_by_space</b>
           <b>char     p_sign_posn</b>
           <b>char    *thousands_sep</b>

       The <i>&lt;locale.h&gt;</i> header shall define  NULL  (as
described in <i>&lt;stddef.h&gt;</i>)
       and at least the following as macros:

       LC_ALL
       LC_COLLATE
       LC_CTYPE
       LC_MESSAGES
       LC_MONETARY
       LC_NUMERIC
       LC_TIME

       which  shall  expand  to integer constant expressions with
distinct
       values for use as the  first  argument  to  the  <i>setlo‐
cale</i>() function.

       Implementations  may  add  additional masks using the form
<i>LC_*</i> and an
       uppercase letter.

       The <i>&lt;locale.h&gt;</i> header shall contain at  least
the following macros
       representing  bitmasks for use with the <i>newlocale</i>()
function for each
       supported locale category: LC_COLLATE_MASK LC_CTYPE_MASK
       LC_MESSAGES_MASK     LC_MONETARY_MASK      LC_NUMERIC_MASK
LC_TIME_MASK

       Implementations  may  add  additional masks using the form
LC_*_MASK.

       In addition, a macro to set the bits  for  all  categories
set shall be
       defined: LC_ALL_MASK

       The  <i>&lt;locale.h&gt;</i>  header shall define LC_GLOB‐
AL_LOCALE, a special locale
       object  descriptor  used  by  the  <i>duplocale</i>()  and
<i>uselocale</i>() functions.

       The <i>&lt;locale.h&gt;</i> header shall define the <b>lo‐
cale_t </b>type, representing a
       locale object.

       The following shall be declared as functions and may  also
be defined
       as  macros.  Function prototypes shall be provided for use
with ISO C
       standard compilers.

           <b>locale_t      duplocale(locale_t);</b>
           <b>void          freelocale(locale_t);</b>
           <b>struct lconv *localeconv(void);</b>
           <b>locale_t       newlocale(int,  const  char  *,  lo‐
cale_t);</b>
           <b>char         *setlocale(int, const char *);</b>
           <b>locale_t      uselocale (locale_t);</b>

       <i>The  following  sections  are  informative.</i>  </pre>
<h2><a  id="APPLICATION_USAGE"  href="#APPLICATION_USAGE"></a>AP‐
PLICATION    USAGE     &nbsp;    &nbsp;    &nbsp;    &nbsp;    <a
href="#top_of_page"><span                             class="top‐
link">top</span></a></h2><pre>
       None.     </pre>   <h2><a   id="RATIONALE"   href="#RATIO‐
NALE"></a>RATIONALE    &nbsp;    &nbsp;    &nbsp;    &nbsp;    <a
href="#top_of_page"><span                             class="top‐
link">top</span></a></h2><pre>
       None.   </pre>  <h2><a  id="FUTURE_DIRECTIONS"  href="#FU‐
TURE_DIRECTIONS"></a>FUTURE DIRECTIONS  &nbsp; &nbsp; &nbsp; &nb‐
sp;        <a        href="#top_of_page"><span        class="top‐
link">top</span></a></h2><pre>
       None.     </pre>   <h2><a   id="SEE_ALSO"   href="#SEE_AL‐
SO"></a>SEE   ALSO     &nbsp;    &nbsp;    &nbsp;    &nbsp;    <a
href="#top_of_page"><span                             class="top‐
link">top</span></a></h2><pre>
       <i>Chapter   8</i>,   <i>Environment   Variables</i>,   <a
href="../man0/stddef.h.0p.html">stddef.h(0p)</a>

       The   System   Interfaces   volume   of  POSIX.1‐2008,  <a
href="../man3/duplocale.3p.html">duplocale(3p)</a>,
       <a   href="../man3/freelocale.3p.html">freelocale(3p)</a>,
<a    href="../man3/localeconv.3p.html">localeconv(3p)</a>,    <a
href="../man3/newlocale.3p.html">newlocale(3p)</a>,            <a
href="../man3/setlocale.3p.html">setlocale(3p)</a>,
       <a      href="../man3/uselocale.3p.html">uselocale(3p)</a>
</pre>  <h2><a   id="COPYRIGHT"   href="#COPYRIGHT"></a>COPYRIGHT
&nbsp;   &nbsp;   &nbsp;   &nbsp;   <a  href="#top_of_page"><span
class="top‐link">top</span></a></h2><pre>
       Portions of this text  are  reprinted  and  reproduced  in
electronic form
       from  IEEE Std 1003.1, 2013 Edition, Standard for Informa‐
tion
       Technology ‐‐ Portable Operating System Interface (POSIX),
The Open
       Group  Base  Specifications Issue 7, Copyright (C) 2013 by
the
       Institute of Electrical and Electronics Engineers, Inc and
The Open
       Group.  (This is POSIX.1‐2008 with the 2013 Technical Cor‐
rigendum 1
       applied.) In the event of  any  discrepancy  between  this
version and
       the  original IEEE and The Open Group Standard, the origi‐
nal IEEE and
       The Open Group Standard is the referee document. The orig‐
inal
       Standard     can     be     obtained    online    at    <a
href="http://www.unix.org/online.html">http://www.unix.org/on‐
line.html</a> .

       Any typographical or formatting errors that appear in this
page are
       most likely to have been introduced during the  conversion
of the
       source  files  to  man page format. To report such errors,
see
       <a      href="https://www.kernel.org/doc/man‐pages/report‐
ing_bugs.html">https://www.kernel.org/doc/man‐pages/report‐
ing_bugs.html</a> .

<span class="footline">IEEE/The Open  Group                  2013
locale.h(0P)</span> </pre>

<hr class="end‐man‐text" />

<hr class="start‐footer" />

<div class="footer">

<table class="colophon‐table">
    <tr>
    <td class="pub‐info">
        <p>
            HTML rendering created 2019‐08‐02
            by  <a  href="http://man7.org/mtk/index.html">Michael
Kerrisk</a>,
            author of
            <a  href="http://man7.org/tlpi/"><em>The  Linux  Pro‐
gramming Interface</em></a>,
            maintainer of the
            <a href="https://www.kernel.org/doc/man‐pages/">Linux
<em>man‐pages</em> project</a>.
        </p>
        <p>
            For details of in‐depth
            <strong>Linux/UNIX system programming training  cour‐
ses</strong>
            that  I  teach,  look <a href="http://man7.org/train‐
ing/">here</a>.
        </p>
        <p>
            Hosting   by    <a    href="http://www.jambit.com/in‐
dex_en.html">jambit GmbH</a>.
        </p>
        <p>
            <a href="http://validator.w3.org/check?uri=referer">
            <img src="http://www.w3.org/Icons/valid‐xhtml11"
                alt="Valid XHTML 1.1" height="31" width="88" />
            </a>
        </p>
    </td>
    <td class="colophon‐divider">
    </td>
    <td class="tlpi‐cover">
        <a                      href="http://man7.org/tlpi/"><img
src="http://man7.org/tlpi/cover/TLPI‐front‐cover‐vsmall.png"
alt="Cover of TLPI" /></a>
    </td>
    </tr> </table>

</div>

<hr class="end‐footer" />

</body> </html>