1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-27 00:42:10 +01:00
Files
archived-doc-es/reference/strings/functions/localeconv.xml
Yago Ferrer 4a2bed8052 More files from: 'lboshell'
git-svn-id: https://svn.php.net/repository/phpdoc/es/trunk@297985 c90b9560-bf6c-de11-be94-00142212c4b1
2010-04-14 10:23:56 +00:00

255 lines
7.0 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: af4410a7e15898c3dbe83d6ea38246745ed9c6fb Maintainer: lboshell Status: ready -->
<refentry xml:id="function.localeconv" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>localeconv</refname>
<refpurpose>Obtener información sobre el formato numérico</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<type>array</type><methodname>localeconv</methodname>
<void/>
</methodsynopsis>
<para>
Devuelve una matriz asociativa que contiene información de los formatos
numérico y monetario, localizados.
</para>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
<function>localeconv</function> devuelve información basada en la
localidad actual, tal y como haya sido definida mediante
<function>setlocale</function>. La matriz asociativa que devuelve
contiene los siguientes campos:
<informaltable >
<tgroup cols="2">
<thead>
<row>
<entry>Elemento de la matriz</entry>
<entry>Descripción</entry>
</row>
</thead>
<tbody>
<row>
<entry>decimal_point</entry>
<entry>Caracter de punto decimal</entry>
</row>
<row>
<entry>thousands_sep</entry>
<entry>Separador de miles</entry>
</row>
<row>
<entry>grouping</entry>
<entry>Matriz que contiene agrupaciones numéricas</entry>
</row>
<row>
<entry>int_curr_symbol</entry>
<entry>Símbolo internacional de moneda (i.e. USD)</entry>
</row>
<row>
<entry>currency_symbol</entry>
<entry>Símbolo local de moneda (i.e. $)</entry>
</row>
<row>
<entry>mon_decimal_point</entry>
<entry>Caracter de punto decimal monetario</entry>
</row>
<row>
<entry>mon_thousands_sep</entry>
<entry>Separador de miles monetario</entry>
</row>
<row>
<entry>mon_grouping</entry>
<entry>Matriz que contiene agrupaciones de moneda</entry>
</row>
<row>
<entry>positive_sign</entry>
<entry>Signo para valores positivos</entry>
</row>
<row>
<entry>negative_sign</entry>
<entry>Signo para valores negativos</entry>
</row>
<row>
<entry>int_frac_digits</entry>
<entry>Dígitos fraccionarios internacionales</entry>
</row>
<row>
<entry>frac_digits</entry>
<entry>Dígitos fraccionarios locales</entry>
</row>
<row>
<entry>p_cs_precedes</entry>
<entry>
&true; si currency_symbol precede un valor positivo, &false;
si lo sucede
</entry>
</row>
<row>
<entry>p_sep_by_space</entry>
<entry>
&true; si un espacio separa currency_symbol de un valor positivo,
&false; de lo contrario
</entry>
</row>
<row>
<entry>n_cs_precedes</entry>
<entry>
&true; si currency_symbol precede un valor negativo, &false;
si lo sucede
</entry>
</row>
<row>
<entry>n_sep_by_space</entry>
<entry>
&true; si un espacio separa currency_symbol de un valor
negativo, &false; de lo contrario
</entry>
</row>
<row valign="top">
<entry>p_sign_posn</entry>
<entry>
<simplelist>
<member>0 - Paréntesis rodean la cantidad y
currency_symbol</member>
<member>1 - La cadena de signo precede la cantidad y
currency_symbol</member>
<member>2 - La cadena de signo sucede la cantidad y
currency_symbol</member>
<member>3 - La cadena de signo precede inmediatamente
currency_symbol</member>
<member>4 - La cadena de signo sucede inmediatamente
currency_symbol</member>
</simplelist>
</entry>
</row>
<row valign="top">
<entry>n_sign_posn</entry>
<entry>
<simplelist>
<member>0 - Paréntesis rodean la cantidad y
currency_symbol</member>
<member>1 - La cadena de signo precede la cantidad y
currency_symbol</member>
<member>2 - La cadena de signo sucede la cantidad y
currency_symbol</member>
<member>3 - La cadena de signo precede inmediatamente
currency_symbol</member>
<member>4 - La cadena de signo sucede inmediatamente
currency_symbol</member>
</simplelist>
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
<para>
Los valores de <literal>p_sign_posn</literal> y
<literal>n_sign_posn</literal> contienen una cadena de opciones de
formato. Cada número representa una de las condiciones listadas
anteriormente.
</para>
<para>
Los campos de agrupamiento contienen matrices que definen el modo en que
los números deben ser agrupados. Por ejemplo, el campo de agrupamiento
monetario para la localidad nl_NL (en modo UTF-8 con el signo de euro),
tendría una matriz de 2 elementos con los valores 3 y 3. Entre más alto
sea el índice dentro de la matriz, lo más lejos hacia la izquierda se
encuentra el agrupamiento. Si un elemento de la matriz es igual a
<constant>CHAR_MAX</constant>, no se realiza ningún agrupamiento
posterior. Si un elemento de la matriz es igual a 0, el elemento anterior
deberá ser usado.
</para>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>localeconv</function></title>
<programlisting role="php">
<![CDATA[
<?php
if (false !== setlocale(LC_ALL, 'nl_NL.UTF-8@euro')) {
$info_localidad = localeconv();
print_r($info_localidad);
}
?>
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Array
(
[decimal_point] => .
[thousands_sep] =>
[int_curr_symbol] => EUR
[currency_symbol] => €
[mon_decimal_point] => ,
[mon_thousands_sep] =>
[positive_sign] =>
[negative_sign] => -
[int_frac_digits] => 2
[frac_digits] => 2
[p_cs_precedes] => 1
[p_sep_by_space] => 1
[n_cs_precedes] => 1
[n_sep_by_space] => 1
[p_sign_posn] => 1
[n_sign_posn] => 2
[grouping] => Array
(
)
[mon_grouping] => Array
(
[0] => 3
[1] => 3
)
)
]]>
</screen>
</example>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member><function>setlocale</function></member>
</simplelist>
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->