📄 localeconv.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"><html><head><!-- Copyright 1997 The Open Group, All Rights Reserved --><title>localeconv</title></head><body bgcolor=white><center><font size=2>The Single UNIX ® Specification, Version 2<br>Copyright © 1997 The Open Group</font></center><hr size=2 noshade><h4><a name = "tag_000_007_381"> </a>NAME</h4><blockquote>localeconv - determine the program locale</blockquote><h4><a name = "tag_000_007_382"> </a>SYNOPSIS</h4><blockquote><pre><code>#include <<a href="locale.h.html">locale.h</a>>struct lconv *localeconv(void);</code></pre></blockquote><h4><a name = "tag_000_007_383"> </a>DESCRIPTION</h4><blockquote>The<i>localeconv()</i>function sets the components of an object with the type<b>struct lconv</b>with the values appropriate for the formatting of numericquantities (monetary and otherwise) according to the rules of thecurrent locale.<p>The members of the structure with type<b>char *</b>are pointers to strings, any of which (except <b>decimal_point</b>)can point to "", to indicate that the value is not available inthe current locale or is of zero length.The members with type <b>char</b> are non-negative numbers, any ofwhich can be {CHAR_MAX} to indicate that the value is not availablein the current locale.<p>The members include the following:<dl compact><dt><b>char *decimal_point</b><dd><br>The radix character used to format non-monetaryquantities.<dt><b>char *thousands_sep</b><dd><br>The character used to separate groups of digits before thedecimal-point character in formatted non-monetary quantities.<dt><b>char *grouping</b><dd><br>A string whose elements taken as one-byte integer valuesindicate the size of each group of digitsin formatted non-monetary quantities.<dt><b>char *int_curr_symbol</b><dd><br>The international currency symbol applicable to the currentlocale.The first three characters contain the alphabetic internationalcurrency symbol in accordance with those specified inthe .The fourth character (immediately preceding the null byte)is the character used to separate the international currencysymbol from the monetary quantity.<dt><b>char *currency_symbol</b><dd><br>The local currency symbol applicable to the current locale.<dt><b>char *mon_decimal_point</b><dd><br>The radix character used to format monetary quantities.<dt><b>char *mon_thousands_sep</b><dd><br>The separator for groups of digits before the decimal-point informatted monetary quantities.<dt><b>char *mon_grouping</b><dd><br>A string whose elements taken as one-byte integer valuesindicate the size of each group of digitsin formatted monetary quantities.<dt><b>char *positive_sign</b><dd><br>The string used to indicate a non-negative valued formattedmonetary quantity.<dt><b>char *negative_sign</b><dd><br>The string used to indicate a negative valued formatted monetaryquantity.<dt><b>char int_frac_digits</b><dd>The number of fractional digits (those after the decimal-point)to be displayed in an internationally formatted monetaryquantity.<dt><b>char frac_digits</b><dd>The number of fractional digits (those after the decimal-point)to be displayed in a formatted monetary quantity.<dt><b>char p_cs_precedes</b><dd>Set to 1 if the <b>currency_symbol</b> or <b>int_curr_symbol</b> precedes the value for a non-negative formatted monetaryquantity. Set to 0 if the symbol succeeds the value.<dt><b>char p_sep_by_space</b><dd>Set to 0 if no space separates the <b>currency_symbol</b> or <b>int_curr_symbol</b>from the value for a non-negative formatted monetary quantity.Set to 1 if a space separates the symbol from the value; and set to 2 if a space separates the symbol and the sign string, ifadjacent.<dt><b>char n_cs_precedes</b><dd>Set to 1 if the <b>currency_symbol</b> or <b>int_curr_symbol</b> precedes the value for a negative formatted monetaryquantity. Set to 0 if the symbol succeeds the value.<dt><b>char n_sep_by_space</b><dd>Set to 0 if no space separates the <b>currency_symbol</b> or <b>int_curr_symbol</b>from the value for a negative formatted monetary quantity.Set to 1 if a space separates the symbol from the value; and set to 2 if a space separates the symbol and the sign string, ifadjacent.<dt><b>char p_sign_posn</b><dd>Set to a value indicating the positioning of the<b>positive_sign</b> for a non-negative formatted monetaryquantity.<dt><b>char n_sign_posn</b><dd>Set to a value indicating the positioning of the<b>negative_sign</b> for a negative formatted monetaryquantity.</dl><p>The elements of <b>grouping</b> and <b>mon_grouping</b> areinterpreted according to the following:<dl compact><dt>{CHAR_MAX}<dd>No further grouping is to be performed.<dt>0<dd>The previous element is to be repeatedly used for the remainderof the digits.<dt><i>other</i><dd>The integer value is the number of digits that comprise thecurrent group.The next element is examined to determine the size of the nextgroup of digits before the current group.</dl><p>The values of <b>p_sign_posn</b> and <b>n_sign_posn</b> areinterpreted according to the following:<dl compact><dt>0<dd>Parentheses surround the quantity and <b>currency_symbol</b> or <b>int_curr_symbol</b>.<dt>1<dd>The sign string precedes the quantity and <b>currency_symbol</b> or <b>int_curr_symbol</b>.<dt>2<dd>The sign string succeeds the quantity and <b>currency_symbol</b> or <b>int_curr_symbol</b>.<dt>3<dd>The sign string immediately precedes the <b>currency_symbol</b> or <b>int_curr_symbol</b>.<dt>4<dd>The sign string immediately succeeds the <b>currency_symbol</b> or <b>int_curr_symbol</b>.</dl><p>The implementation will behave as if no function in this specificationcalls<i>localeconv()</i>.</blockquote><h4><a name = "tag_000_007_384"> </a>RETURN VALUE</h4><blockquote>The<i>localeconv()</i>function returns a pointer to the filled-in object.The structure pointed to by the return value must not bemodified by the program, but may be overwritten by a subsequentcall to<i>localeconv()</i>.In addition, calls to<i><a href="setlocale.html">setlocale()</a></i>with the categories LC_ALL, LC_MONETARY, or LC_NUMERICmay overwrite the contents of the structure.<br></blockquote><h4><a name = "tag_000_007_385"> </a>ERRORS</h4><blockquote>No errors are defined.</blockquote><h4><a name = "tag_000_007_386"> </a>EXAMPLES</h4><blockquote>None.</blockquote><h4><a name = "tag_000_007_387"> </a>APPLICATION USAGE</h4><blockquote>The following table illustrates the rules which may be used byfour countries to format monetary quantities.<p><table bordercolor=#000000 border=1 align=center><tr valign=top><th align=center><b>Country</b><th align=center><b>Positive Format</b><th align=center><b>Negative Format</b><th align=center><b>International Format</b><tr valign=top><td align=left>Italy<td align=left>L.1.230<td align=left>-L.1.230<td align=left>ITL.1.230<tr valign=top><td align=left>Netherlands<td align=left>F 1.234,56<td align=left>F -1.234,56<td align=left>NLG 1.234,56<tr valign=top><td align=left>Norway<td align=left>kr1.234,56<td align=left>kr1.234,56-<td align=left>NOK 1.234,56<tr valign=top><td align=left>Switzerland<td align=left>SFrs.1,234.56<td align=left>SFrs.1,234.56C<td align=left>CHF 1,234.56</table><p>For these four countries, the respective values for the monetarymembers of the structure returned by<i>localeconv()</i>are:<p><table bordercolor=#000000 border=1 align=center><tr valign=top><th align=center><b> </b><th align=center><b>Italy</b><th align=center><b>Netherlands</b><th align=center><b>Norway</b><th align=center><b>Switzerland</b><tr valign=top><td align=left><b>int_curr_symbol</b><td align=left>"ITL."<td align=left>"NLG "<td align=left>"NOK "<td align=left>"CHF "<tr valign=top><td align=left><b>currency_symbol</b><td align=left>"L."<td align=left>"F"<td align=left>"kr"<td align=left>"SFrs."<tr valign=top><td align=left><b>mon_decimal_point</b><td align=left>""<td align=left>","<td align=left>","<td align=left>"."<tr valign=top><td align=left><b>mon_thousands_sep</b><td align=left>"."<td align=left>"."<td align=left>"."<td align=left>","<tr valign=top><td align=left><b>mon_grouping</b><td align=left>"\3"<td align=left>"\3"<td align=left>"\3"<td align=left>"\3"<tr valign=top><td align=left><b>positive_sign</b><td align=left>""<td align=left>""<td align=left>""<td align=left>""<tr valign=top><td align=left><b>negative_sign</b><td align=left>"-"<td align=left>"-"<td align=left>"-"<td align=left>"C"<tr valign=top><td align=left><b>int_frac_digits</b><td align=left>0<td align=left>2<td align=left>2<td align=left>2<tr valign=top><td align=left><b>frac_digits</b><td align=left>0<td align=left>2<td align=left>2<td align=left>2<tr valign=top><td align=left><b>p_cs_precedes</b><td align=left>1<td align=left>1<td align=left>1<td align=left>1<tr valign=top><td align=left><b>p_sep_by_space</b><td align=left>0<td align=left>1<td align=left>0<td align=left>0<tr valign=top><td align=left><b>n_cs_precedes</b><td align=left>1<td align=left>1<td align=left>1<td align=left>1<tr valign=top><td align=left><b>n_sep_by_space</b><td align=left>0<td align=left>1<td align=left>0<td align=left>0<tr valign=top><td align=left><b>p_sign_posn</b><td align=left>1<td align=left>1<td align=left>1<td align=left>1<tr valign=top><td align=left><b>n_sign_posn</b><td align=left>1<td align=left>4<td align=left>2<td align=left>2</table></blockquote><h4><a name = "tag_000_007_388"> </a>FUTURE DIRECTIONS</h4><blockquote>None.</blockquote><h4><a name = "tag_000_007_389"> </a>SEE ALSO</h4><blockquote><i><a href="isalpha.html">isalpha()</a></i>,<i><a href="isascii.html">isascii()</a></i>,<i><a href="nl_langinfo.html">nl_langinfo()</a></i>,<i><a href="printf.html">printf()</a></i>,<i><a href="scanf.html">scanf()</a></i>,<i><a href="setlocale.html">setlocale()</a></i>,<i><a href="strcat.html">strcat()</a></i>,<i><a href="strchr.html">strchr()</a></i>,<i><a href="strcmp.html">strcmp()</a></i>,<i><a href="strcoll.html">strcoll()</a></i>,<i><a href="strcpy.html">strcpy()</a></i>,<i><a href="strftime.html">strftime()</a></i>,<i><a href="strlen.html">strlen()</a></i>,<i><a href="strpbrk.html">strpbrk()</a></i>,<i><a href="strspn.html">strspn()</a></i>,<i><a href="strtok.html">strtok()</a></i>,<i><a href="strxfrm.html">strxfrm()</a></i>,<i><a href="strtod.html">strtod()</a></i>,<i><a href="langinfo.h.html"><langinfo.h></a></i>,<i><a href="locale.h.html"><locale.h></a></i>.</blockquote><h4>DERIVATION</h4><blockquote>Derived from the ANSI C standard.</blockquote><hr size=2 noshade><center><font size=2>UNIX ® is a registered Trademark of The Open Group.<br>Copyright © 1997 The Open Group<br> [ <a href="../index.html">Main Index</a> | <a href="../xshix.html">XSH</a> | <a href="../xcuix.html">XCU</a> | <a href="../xbdix.html">XBD</a> | <a href="../cursesix.html">XCURSES</a> | <a href="../xnsix.html">XNS</a> ]</font></center><hr size=2 noshade></body></html>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -