uTools-Manuals/docs/php/localeconv.html
2019-04-28 19:00:34 +08:00

246 lines
8.4 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=UTF-8">
<title>Get numeric formatting information</title>
</head>
<body class="docs"><div id="layout">
<div id="layout-content"><div id="function.localeconv" class="refentry">
<div class="refnamediv">
<h1 class="refname">localeconv</h1>
<p class="verinfo">(PHP 4 &gt;= 4.0.5, PHP 5, PHP 7)</p><p class="refpurpose"><span class="refname">localeconv</span> &mdash; <span class="dc-title">Get numeric formatting information</span></p>
</div>
<div class="refsect1 description" id="refsect1-function.localeconv-description">
<h3 class="title">说明</h3>
<div class="methodsynopsis dc-description">
<span class="methodname"><strong>localeconv</strong></span>
( <span class="methodparam">void</span>
) : <span class="type">array</span></div>
<p class="para rdfs-comment">
Returns an associative array containing localized numeric and
monetary formatting information.
</p>
</div>
<div class="refsect1 returnvalues" id="refsect1-function.localeconv-returnvalues">
<h3 class="title">返回值</h3>
<p class="para">
<span class="function"><strong>localeconv()</strong></span> returns data based upon the current locale
as set by <span class="function"><a href="setlocale.html" class="function">setlocale()</a></span>. The associative array that is
returned contains the following fields:
<table class="doctable informaltable">
<thead>
<tr>
<th>Array element</th>
<th>Description</th>
</tr>
</thead>
<tbody class="tbody">
<tr>
<td>decimal_point</td>
<td>Decimal point character</td>
</tr>
<tr>
<td>thousands_sep</td>
<td>Thousands separator</td>
</tr>
<tr>
<td>grouping</td>
<td>Array containing numeric groupings</td>
</tr>
<tr>
<td>int_curr_symbol</td>
<td>International currency symbol (i.e. USD)</td>
</tr>
<tr>
<td>currency_symbol</td>
<td>Local currency symbol (i.e. $)</td>
</tr>
<tr>
<td>mon_decimal_point</td>
<td>Monetary decimal point character</td>
</tr>
<tr>
<td>mon_thousands_sep</td>
<td>Monetary thousands separator</td>
</tr>
<tr>
<td>mon_grouping</td>
<td>Array containing monetary groupings</td>
</tr>
<tr>
<td>positive_sign</td>
<td>Sign for positive values</td>
</tr>
<tr>
<td>negative_sign</td>
<td>Sign for negative values</td>
</tr>
<tr>
<td>int_frac_digits</td>
<td>International fractional digits</td>
</tr>
<tr>
<td>frac_digits</td>
<td>Local fractional digits</td>
</tr>
<tr>
<td>p_cs_precedes</td>
<td>
<strong><code>TRUE</code></strong> if currency_symbol precedes a positive value, <strong><code>FALSE</code></strong>
if it succeeds one
</td>
</tr>
<tr>
<td>p_sep_by_space</td>
<td>
<strong><code>TRUE</code></strong> if a space separates currency_symbol from a positive
value, <strong><code>FALSE</code></strong> otherwise
</td>
</tr>
<tr>
<td>n_cs_precedes</td>
<td>
<strong><code>TRUE</code></strong> if currency_symbol precedes a negative value, <strong><code>FALSE</code></strong>
if it succeeds one
</td>
</tr>
<tr>
<td>n_sep_by_space</td>
<td>
<strong><code>TRUE</code></strong> if a space separates currency_symbol from a negative
value, <strong><code>FALSE</code></strong> otherwise
</td>
</tr>
<tr style="vertical-align: top;">
<td>p_sign_posn</td>
<td>
<ul class="simplelist">
<li class="member">0 - Parentheses surround the quantity and currency_symbol</li>
<li class="member">1 - The sign string precedes the quantity and currency_symbol</li>
<li class="member">2 - The sign string succeeds the quantity and currency_symbol</li>
<li class="member">3 - The sign string immediately precedes the currency_symbol</li>
<li class="member">4 - The sign string immediately succeeds the currency_symbol</li>
</ul>
</td>
</tr>
<tr style="vertical-align: top;">
<td>n_sign_posn</td>
<td>
<ul class="simplelist">
<li class="member">0 - Parentheses surround the quantity and currency_symbol</li>
<li class="member">1 - The sign string precedes the quantity and currency_symbol</li>
<li class="member">2 - The sign string succeeds the quantity and currency_symbol</li>
<li class="member">3 - The sign string immediately precedes the currency_symbol</li>
<li class="member">4 - The sign string immediately succeeds the currency_symbol</li>
</ul>
</td>
</tr>
</tbody>
</table>
</p>
<p class="para">
The <em>p_sign_posn</em>, and <em>n_sign_posn</em> contain a string
of formatting options. Each number representing one of the above listed conditions.
</p>
<p class="para">
The grouping fields contain arrays that define the way numbers should be
grouped. For example, the monetary grouping field for the nl_NL locale (in
UTF-8 mode with the euro sign), would contain a 2 item array with the
values 3 and 3. The higher the index in the array, the farther left the
grouping is. If an array element is equal to <strong><code>CHAR_MAX</code></strong>,
no further grouping is done. If an array element is equal to 0, the previous
element should be used.
</p>
</div>
<div class="refsect1 examples" id="refsect1-function.localeconv-examples">
<h3 class="title">范例</h3>
<p class="para">
<div class="example" id="example-5918">
<p><strong>Example #1 <span class="function"><strong>localeconv()</strong></span> example</strong></p>
<div class="example-contents">
<div class="phpcode"><pre><span style="color: #000000">
<span style="color: #0000BB">&lt;?php<br /></span><span style="color: #007700">if&nbsp;(</span><span style="color: #0000BB">false&nbsp;</span><span style="color: #007700">!==&nbsp;</span><span style="color: #0000BB">setlocale</span><span style="color: #007700">(</span><span style="color: #0000BB">LC_ALL</span><span style="color: #007700">,&nbsp;</span><span style="color: #DD0000">'nl_NL.UTF-8@euro'</span><span style="color: #007700">))&nbsp;{<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">$locale_info&nbsp;</span><span style="color: #007700">=&nbsp;</span><span style="color: #0000BB">localeconv</span><span style="color: #007700">();<br />&nbsp;&nbsp;&nbsp;&nbsp;</span><span style="color: #0000BB">print_r</span><span style="color: #007700">(</span><span style="color: #0000BB">$locale_info</span><span style="color: #007700">);<br />}<br /></span><span style="color: #0000BB">?&gt;</span>
</span>
</pre></div>
</div>
<div class="example-contents"><p>以上例程会输出:</p></div>
<div class="example-contents screen">
<div class="cdata"><pre>
Array
(
[decimal_point] =&gt; .
[thousands_sep] =&gt;
[int_curr_symbol] =&gt; EUR
[currency_symbol] =&gt;
[mon_decimal_point] =&gt; ,
[mon_thousands_sep] =&gt;
[positive_sign] =&gt;
[negative_sign] =&gt; -
[int_frac_digits] =&gt; 2
[frac_digits] =&gt; 2
[p_cs_precedes] =&gt; 1
[p_sep_by_space] =&gt; 1
[n_cs_precedes] =&gt; 1
[n_sep_by_space] =&gt; 1
[p_sign_posn] =&gt; 1
[n_sign_posn] =&gt; 2
[grouping] =&gt; Array
(
)
[mon_grouping] =&gt; Array
(
[0] =&gt; 3
[1] =&gt; 3
)
)
</pre></div>
</div>
</div>
</p>
</div>
<div class="refsect1 seealso" id="refsect1-function.localeconv-seealso">
<h3 class="title">参见</h3>
<p class="para">
<ul class="simplelist">
<li class="member"><span class="function"><a href="setlocale.html" class="function" rel="rdfs-seeAlso">setlocale()</a> - 设置地区信息</span></li>
</ul>
</p>
</div>
</div></div></div></body></html>