LMPX.COM |
Home | Linux | Mysql | PHP | XML | ||
|
|
|||
From: Leonardo Boshell Date: Thu Jul 31 19:29:45 2008 Subject: cvs: phpdoc-es /language/types string.xml /reference/array/functions array-combine.xml array-map.xml array-multisort.xml array-rand.xml
array-reduce.xml array-search.xml array-sum.xml array-udiff-assoc.xml array-udiff-uassoc.xml array-udiff.xml array-unique.xml
array-walk-recursive.xml natcasesort.xml natsort.xml range.xml usort.xml
lboshell Fri Aug 1 01:29:45 2008 UTC
Modified files:
/phpdoc-es/language/types string.xml
/phpdoc-es/reference/array/functions array-combine.xml
array-map.xml
array-multisort.xml
array-rand.xml
array-reduce.xml
array-search.xml array-sum.xml
array-udiff-assoc.xml
array-udiff-uassoc.xml
array-udiff.xml
array-unique.xml
array-walk-recursive.xml
natcasesort.xml natsort.xml
range.xml usort.xml
Log:
Actualizaciones
http://cvs.php.net/viewvc.cgi/phpdoc-es/language/types/string.xml?r1=1.1&r2=1.2&diff_format=u
Index: phpdoc-es/language/types/string.xml
diff -u phpdoc-es/language/types/string.xml:1.1 phpdoc-es/language/types/string.xml:1.2
--- phpdoc-es/language/types/string.xml:1.1 Thu Jun 26 01:44:08 2008
+++ phpdoc-es/language/types/string.xml Fri Aug 1 01:29:45 2008
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.1 $ -->
-<!-- EN-Revision: 1.10 Maintainer: lboshell Status: ready -->
+<!-- $Revision: 1.2 $ -->
+<!-- EN-Revision: 1.12 Maintainer: lboshell Status: ready -->
<sect1 xml:id="language.types.string">
<title>Cadenas</title>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-combine.xml?r1=1.8&r2=1.9&diff_format=u
Index: phpdoc-es/reference/array/functions/array-combine.xml
diff -u phpdoc-es/reference/array/functions/array-combine.xml:1.8 phpdoc-es/reference/array/functions/array-combine.xml:1.9
--- phpdoc-es/reference/array/functions/array-combine.xml:1.8 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-combine.xml Fri Aug 1 01:29:45 2008
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.9 Maintainer: lboshell Status: ready -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.10 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-combine" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_combine</refname>
@@ -31,7 +31,8 @@
<term><parameter>claves</parameter></term>
<listitem>
<para>
- Matriz de las claves a usar
+ Matriz de las claves a usar. Cualquier valor inválido para la clave
+ será convertido a <type>string</type>.
</para>
</listitem>
</varlistentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-map.xml?r1=1.11&r2=1.12&diff_format=u
Index: phpdoc-es/reference/array/functions/array-map.xml
diff -u phpdoc-es/reference/array/functions/array-map.xml:1.11 phpdoc-es/reference/array/functions/array-map.xml:1.12
--- phpdoc-es/reference/array/functions/array-map.xml:1.11 Tue Jun 26 23:18:55 2007
+++ phpdoc-es/reference/array/functions/array-map.xml Fri Aug 1 01:29:45 2008
@@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.11 $ -->
-<!-- EN-Revision: 1.19 Maintainer: lboshell Status: ready -->
+<!-- $Revision: 1.12 $ -->
+<!-- EN-Revision: 1.20 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-map" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_map</refname>
@@ -257,6 +257,68 @@
</screen>
</example>
</para>
+ <para>
+ Si el argumento matriz contiene claves tipo cadena, entonces la matriz
+ devuelta tendrá claves tipo cadena si y solo si es pasada exactamente una
+ matriz. Si más de un argumento es pasado, entonces la matriz devuelta
+ siempre tendrá claves tipo entero.
+ </para>
+ <para>
+ <example>
+ <title><function>array_map</function> - con claves tipo cadena</title>
+ <programlisting role="php">
+<![CDATA[
+<?php
+$matriz = array("clave_cadena" => "valor");
+function llamada1($a) {
+ return array ($a);
+}
+function llamada2($a, $b) {
+ return array ($a, $b);
+}
+var_dump(array_map("llamada1", $matriz));
+var_dump(array_map("llamada2", $matriz, $matriz));
+var_dump(array_map(null, $matriz));
+var_dump(array_map(null, $matriz, $matriz));
+?>
+]]>
+ </programlisting>
+ &example.outputs;
+ <screen>
+<![CDATA[
+array(1) {
+ ["clave_cadena"]=>
+ array(1) {
+ [0]=>
+ string(5) "valor"
+ }
+}
+array(1) {
+ [0]=>
+ array(2) {
+ [0]=>
+ string(5) "valor"
+ [1]=>
+ string(5) "valor"
+ }
+}
+array(1) {
+ ["clave_cadena"]=>
+ string(5) "valor"
+}
+array(1) {
+ [0]=>
+ array(2) {
+ [0]=>
+ string(5) "valor"
+ [1]=>
+ string(5) "valor"
+ }
+}
+]]>
+ </screen>
+ </example>
+ </para>
</refsect1>
<refsect1 role="seealso">
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-multisort.xml?r1=1.10&r2=1.11&diff_format=u
Index: phpdoc-es/reference/array/functions/array-multisort.xml
diff -u phpdoc-es/reference/array/functions/array-multisort.xml:1.10 phpdoc-es/reference/array/functions/array-multisort.xml:1.11
--- phpdoc-es/reference/array/functions/array-multisort.xml:1.10 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-multisort.xml Fri Aug 1 01:29:45 2008
@@ -1,27 +1,21 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.19 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.11 -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.22 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-multisort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_multisort</refname>
<refpurpose>Ordena múltiples matrices, o matrices
multi-dimensionales</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>array_multisort</methodname>
- <methodparam><type>array</type><parameter>matriz1</parameter></methodparam>
+ <methodparam><type>array</type><parameter>matriz</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>arg</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>...</parameter></methodparam>
- <methodparam choice="opt"><type>array</type><parameter>...</parameter></methodparam>
- <!-- Parameters don't need to be passed by reference -->
</methodsynopsis>
<para>
- &return.success;
- </para>
- <para>
<function>array_multisort</function> puede usarse para ordenar varias
matrices al tiempo, o una matriz multi-dimensional por una o más
dimensiones.
@@ -30,64 +24,60 @@
Las llaves asociativas (<type>string</type>) son conservadas, aunque las
llaves numéricas son re-indexadas.
</para>
+ </refsect1>
+
+ <refsect1 role="parameters">
+ &reftitle.parameters;
<para>
- Las matrices de entrada son tratadas como columnas de una tabla que
- deberá ser ordenada por filas - de forma similar a la funcionalidad de
- una sentencia SQL ORDER BY. La primera matriz es considerada la primaria
- para el ordenamiento. Las filas (valores) en esa matriz que sean
- comparadas como iguales son ordenadas por la siguiente matriz de entrada,
- y así sucesivamente.
- </para>
- <para>
- La estructura de argumentos de esta función es un poco inusual, pero
- flexible. El primer argumento debe ser una matriz. Subsecuentemente, cada
- argumento puede ser o una matriz o una bandera de ordenamiento de las
- siguientes.
- </para>
- <para>
- Banderas de orientación del ordenamiento:
- <itemizedlist>
- <listitem>
- <simpara><constant>SORT_ASC</constant> - Ordenar ascendentemente</simpara>
- </listitem>
- <listitem>
- <simpara><constant>SORT_DESC</constant> - Ordenar descendentemente</simpara>
- </listitem>
- </itemizedlist>
- </para>
- <para>
- Banderas de tipo de ordenamiento
- <itemizedlist>
- <listitem>
- <simpara><constant>SORT_REGULAR</constant> - Comparar elementos
- normalmente</simpara>
- </listitem>
- <listitem>
- <simpara><constant>SORT_NUMERIC</constant> - Comparar elementos
- numéricamente</simpara>
- </listitem>
- <listitem>
- <simpara><constant>SORT_STRING</constant> - Comparar elementos como
- cadenas</simpara>
- </listitem>
- </itemizedlist>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz</parameter></term>
+ <listitem>
+ <para>
+ Un valor tipo <type>array</type> a ordenar.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>arg</parameter></term>
+ <listitem>
+ <para>
+ Opcionalmente otro valor <type>array</type>, u opciones de
+ ordenamiente para el argumento tipo matriz previo:
+ <constant>SORT_ASC</constant>, <constant>SORT_DESC</constant>,
+ <constant>SORT_REGULAR</constant>, <constant>SORT_NUMERIC</constant>,
+ <constant>SORT_STRING</constant>.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>...</parameter></term>
+ <listitem>
+ <para>
+ Argumentos adicionales.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
+ </refsect1>
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
- No pueden especificarse dos banderas de ordenamiento del mismo tipo luego
- de cada matriz. Las banderas de ordenamiento especificadas a continuación
- de un argumento matriz se aplican sólo a esa matriz - estos valores son
- restablecidos de vuelta a <constant>SORT_ASC</constant> y
- <constant>SORT_REGULAR</constant> antes de cada nuevo argumento matriz.
+ &return.success;
</para>
-
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ordenamiento de varias matrices</title>
<programlisting role="php">
<![CDATA[
<?php
-$matriz1 = array("10", 100, 100, "a");
-$matriz2 = array(1, 3, "2", 1);
+$matriz1 = array(10, 100, 100, 0);
+$matriz2 = array(1, 3, 2, 4);
array_multisort($matriz1, $matriz2);
var_dump($matriz1);
@@ -97,29 +87,28 @@
</programlisting>
<para>
En este ejemplo, después del ordenamiento, la primera matriz contendrá
- los valores 10, "a", 100, 100. La segunda matriz contendrá 1, 1, "2",
- 3. Las entradas en la segunda matriz que correspondían a las entradas
+ los valores 0, 10, 100, 100. La segunda matriz contendrá 4, 1, 2, 3.
+ Las entradas en la segunda matriz que correspondían a las entradas
idénticas de la primera matriz (100 y 100) fueron ordenadas también.
</para>
<screen>
<![CDATA[
array(4) {
- [0]=> string(2) "10"
- [1]=> string(1) "a"
+ [0]=> int(0)
+ [1]=> int(10)
[2]=> int(100)
[3]=> int(100)
}
array(4) {
- [0]=> int(1)
+ [0]=> int(4)
[1]=> int(1)
- [2]=> string(1) "2"
+ [2]=> int(2)
[3]=> int(3)
}
]]>
</screen>
</example>
</para>
-
<para>
<example>
<title>Ordenamiento de una matriz multi-dimensional</title>
@@ -164,7 +153,6 @@
</screen>
</example>
</para>
-
<para>
<example>
<title>Ordenamiento de resultados de una base de datos</title>
@@ -246,7 +234,6 @@
</screen>
</example>
</para>
-
<para>
<example>
<title>Ordenamiento insensible a mayúsculas/minúsculas</title>
@@ -287,7 +274,6 @@
</screen>
</example>
</para>
-
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-rand.xml?r1=1.5&r2=1.6&diff_format=u
Index: phpdoc-es/reference/array/functions/array-rand.xml
diff -u phpdoc-es/reference/array/functions/array-rand.xml:1.5 phpdoc-es/reference/array/functions/array-rand.xml:1.6
--- phpdoc-es/reference/array/functions/array-rand.xml:1.5 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-rand.xml Fri Aug 1 01:29:45 2008
@@ -1,27 +1,49 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.11 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.13 -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.12 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-rand" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_rand</refname>
<refpurpose>Selecciona una o más entradas aleatorias de una matriz</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>mixed</type><methodname>array_rand</methodname>
- <methodparam><type>array</type><parameter>entrada</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>num_req</parameter></methodparam>
- </methodsynopsis>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>array_rand</methodname>
+ <methodparam><type>array</type><parameter>entrada</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>num_req</parameter></methodparam>
+ </methodsynopsis>
<para>
<function>array_rand</function> es bastante útil cuando desea elegir una
- o más entradas aleatorias de una matriz. Recibe una matriz de
- <parameter>entrada</parameter> y un argumento opcional
- <parameter>num_req</parameter> que especifica cuántas entradas desea
- seleccionar; si no se precisa este argumento, recibe un valor por defecto
- de 1.
+ o más entradas aleatorias de una matriz.
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>entrada</parameter></term>
+ <listitem>
+ <para>
+ La matriz de entrada.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>num_req</parameter></term>
+ <listitem>
+ <para>
+ Especifica cuántas entradas desea elegir - si no se especifica, el
+ valor predeterminado es 1.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
Si está eligiendo únicamente una entrada, <function>array_rand</function>
devuelve la clave de una entrada al azar. De lo contrario, devuelve una
@@ -29,9 +51,9 @@
forma para que usted pueda elegir claves al igual que valores al azar de
la matriz.
</para>
-
- ¬e.randomseed;
-
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>array_rand</function></title>
@@ -48,8 +70,17 @@
</programlisting>
</example>
</para>
+ </refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
+ ¬e.randomseed;
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Vea también <function>shuffle</function>.
+ <simplelist>
+ <member><function>shuffle</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-reduce.xml?r1=1.5&r2=1.6&diff_format=u
Index: phpdoc-es/reference/array/functions/array-reduce.xml
diff -u phpdoc-es/reference/array/functions/array-reduce.xml:1.5 phpdoc-es/reference/array/functions/array-reduce.xml:1.6
--- phpdoc-es/reference/array/functions/array-reduce.xml:1.5 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-reduce.xml Fri Aug 1 01:29:45 2008
@@ -1,32 +1,74 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.5 $ -->
-<!-- EN-Revision: 1.11 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
+<!-- $Revision: 1.6 $ -->
+<!-- EN-Revision: 1.12 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-reduce" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_reduce</refname>
<refpurpose>Reduce iterativamente una matriz a un solo valor usando una
función llamada de retorno</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>mixed</type><methodname>array_reduce</methodname>
- <methodparam><type>array</type><parameter>entrada</parameter></methodparam>
- <methodparam><type>callback</type><parameter>funcion</parameter></methodparam>
- <methodparam choice="opt"><type>int</type><parameter>inicial</parameter></methodparam>
- </methodsynopsis>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>array_reduce</methodname>
+ <methodparam><type>array</type><parameter>entrada</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>funcion</parameter></methodparam>
+ <methodparam choice="opt"><type>int</type><parameter>inicial</parameter></methodparam>
+ </methodsynopsis>
<para>
<function>array_reduce</function> aplica iterativamente la función
<parameter>funcion</parameter> a los elementos de la matriz
<parameter>entrada</parameter>, con el propósito de reducir la matriz a
- un solo valor. Si el argumento opcional <parameter>inicial</parameter>
- está disponible, éste será usado al inicio del proceso, o como resultado
- final en caso de que la matriz está vacía. Si la matriz está vacía y no
- se pasa el parámetro <parameter>inicial</parameter>,
- <function>array_reduce</function> devuelve &null;.
+ un solo valor.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>entrada</parameter></term>
+ <listitem>
+ <para>
+ La matriz de entrada.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>funcion</parameter></term>
+ <listitem>
+ <para>
+ La función usada como llamada de retorno.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>inicial</parameter></term>
+ <listitem>
+ <para>
+ Si el parámetro opcional <parameter>inicial</parameter> está
+ disponible, éste será usado al comienzo del proceso, o como un
+ resultado final en caso de que la matriz esté vacía.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Devuelve el valor resultante.
</para>
<para>
+ Si la matriz está vacía y no se pasa el parámetro
+ <parameter>inicial</parameter>, <function>array_reduce</function>
+ devuelve &null;.
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
+ <para>
<example>
<title>Ejemplo de <function>array_reduce</function></title>
<programlisting role="php">
@@ -52,18 +94,24 @@
?>
]]>
</programlisting>
+ <para>
+ Esto resultará en que <varname>$b</varname> contenga
+ <literal>15</literal>, <varname>$c</varname> contenga
+ <literal>1200</literal> (= 10*1*2*3*4*5), y <varname>$d</varname>
+ contenga <literal>1</literal>.
+ </para>
</example>
</para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Este ejemplo resultará en <varname>$b</varname> conteniendo el valor
- <literal>15</literal>, <varname>$c</varname> conteniendo
- <literal>1200</literal> (= 10*1*2*3*4*5), y <varname>$d</varname>
- conteniendo <literal>1</literal>.
- </para>
- <para>
- Vea también <function>array_filter</function>,
- <function>array_map</function>, <function>array_unique</function>, y
- <function>array_count_values</function>.
+ <simplelist>
+ <member><function>array_filter</function></member>
+ <member><function>array_map</function></member>
+ <member><function>array_unique</function></member>
+ <member><function>array_count_values</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-search.xml?r1=1.7&r2=1.8&diff_format=u
Index: phpdoc-es/reference/array/functions/array-search.xml
diff -u phpdoc-es/reference/array/functions/array-search.xml:1.7 phpdoc-es/reference/array/functions/array-search.xml:1.8
--- phpdoc-es/reference/array/functions/array-search.xml:1.7 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-search.xml Fri Aug 1 01:29:45 2008
@@ -1,46 +1,72 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.11 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.12 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-search" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_search</refname>
<refpurpose>Busca un valor determinado en una matriz y devuelve la clave
correspondiente en caso de éxito</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>mixed</type><methodname>array_search</methodname>
- <methodparam><type>mixed</type><parameter>aguja</parameter></methodparam>
- <methodparam><type>array</type><parameter>pajar</parameter></methodparam>
- <methodparam choice="opt"><type>bool</type><parameter>estricto</parameter></methodparam>
- </methodsynopsis>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>mixed</type><methodname>array_search</methodname>
+ <methodparam><type>mixed</type><parameter>aguja</parameter></methodparam>
+ <methodparam><type>array</type><parameter>pajar</parameter></methodparam>
+ <methodparam choice="opt"><type>bool</type><parameter>estricto</parameter></methodparam>
+ </methodsynopsis>
<para>
Busca en el <parameter>pajar</parameter> por la
- <parameter>aguja</parameter> y retorna la clave de ésta si se encuentra
- en la matriz, o &false; de lo contrario.
+ <parameter>aguja</parameter>.
</para>
- <note>
- <para>
- Si <parameter>aguja</parameter> es una cadena, la comparación es
- realizada de forma sensible a mayúsculas y minúsculas.
- </para>
- </note>
- <note>
- <para>
- En versiones de PHP anteriores a 4.2.0,
- <function>array_search</function> devuelve &null; en caso de fallo, en
- lugar de &false;.
- </para>
- </note>
- <para>
- Si el opcional tercer argumento, <parameter>estricto</parameter>, se
- define como &true; entonces la función <function>array_search</function>
- también realizará un chequeo sobre los tipos de datos de
- <parameter>aguja</parameter> en el <parameter>pajar</parameter>.
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>aguja</parameter></term>
+ <listitem>
+ <para>
+ El valor a buscar.
+ </para>
+ <note>
+ <para>
+ Si <parameter>aguja</parameter> es una cadena, la comparación es
+ realizada de forma sensible a mayúsculas y minúsculas.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>pajar</parameter></term>
+ <listitem>
+ <para>
+ La matriz.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>estricto</parameter></term>
+ <listitem>
+ <para>
+ Si el opcional tercer argumento, <parameter>estricto</parameter>, se
+ define como &true; entonces la función
+ <function>array_search</function> también realizará un chequeo sobre
+ los <link linkend="language.types">tipos de datos</link> de
+ <parameter>aguja</parameter> en el <parameter>pajar</parameter>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Devuelve la clave de la <parameter>aguja</parameter> si se encuentra en
+ la matriz, o &false; de lo contrario.
</para>
-
<para>
Si la <parameter>aguja</parameter> es encontrada en el
<parameter>pajar</parameter> más de una vez, la primera clave coincidente
@@ -48,6 +74,35 @@
use en su lugar <function>array_keys</function> con el parámetro opcional
<parameter>valor_busqueda</parameter>.
</para>
+ &return.falseproblem;
+ </refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.2.0</entry>
+ <entry>
+ En versiones de PHP anteriores a 4.2.0,
+ <function>array_search</function> devuelve &null; en caso de fallo,
+ en lugar de &false;.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>array_search</function></title>
@@ -63,11 +118,16 @@
</programlisting>
</example>
</para>
- &return.falseproblem;
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Vea también <function>array_keys</function>,
- <function>array_values</function>, <function>array_key_exists</function>,
- y <function>in_array</function>.
+ <simplelist>
+ <member><function>array_keys</function></member>
+ <member><function>array_values</function></member>
+ <member><function>array_key_exists</function></member>
+ <member><function>in_array</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-sum.xml?r1=1.7&r2=1.8&diff_format=u
Index: phpdoc-es/reference/array/functions/array-sum.xml
diff -u phpdoc-es/reference/array/functions/array-sum.xml:1.7 phpdoc-es/reference/array/functions/array-sum.xml:1.8
--- phpdoc-es/reference/array/functions/array-sum.xml:1.7 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-sum.xml Fri Aug 1 01:29:45 2008
@@ -1,22 +1,71 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.13 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.59 -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.14 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-sum" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_sum</refname>
<refpurpose>Calcula la suma de los valores en una matriz</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>number</type><methodname>array_sum</methodname>
- <methodparam><type>array</type><parameter>matriz</parameter></methodparam>
- </methodsynopsis>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>number</type><methodname>array_sum</methodname>
+ <methodparam><type>array</type><parameter>matriz</parameter></methodparam>
+ </methodsynopsis>
<para>
<function>array_sum</function> devuelve la suma de los valores de una
- matriz como un entero o un valor de punto flotante.
+ matriz.
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz</parameter></term>
+ <listitem>
+ <para>
+ La matriz de entrada.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Devuelve la suma de los valores como un valor tipo entero o flotante.
+ </para>
+ </refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.2.1</entry>
+ <entry>
+ Las versiones de PHP anteriores a 4.2.1 modificaban la matriz misma
+ pasada como argumento y convertía las cadenas a números (lo que en
+ la mayoría de casos significaba convertirlas a cero, dependiendo de
+ sus valores).
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplos de <function>array_sum</function></title>
@@ -40,14 +89,6 @@
</screen>
</example>
</para>
- <note>
- <para>
- Las versiones de PHP anteriores a 4.2.1 modificaban la matriz misma
- pasada como argumento y convertía las cadenas a números (lo que en la
- mayoría de casos significaba convertirlas a cero, dependiendo de sus
- valores).
- </para>
- </note>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-udiff-assoc.xml?r1=1.10&r2=1.11&diff_format=u
Index: phpdoc-es/reference/array/functions/array-udiff-assoc.xml
diff -u phpdoc-es/reference/array/functions/array-udiff-assoc.xml:1.10 phpdoc-es/reference/array/functions/array-udiff-assoc.xml:1.11
--- phpdoc-es/reference/array/functions/array-udiff-assoc.xml:1.10 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-udiff-assoc.xml Fri Aug 1 01:29:45 2008
@@ -1,22 +1,73 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.10 $ -->
-<!-- EN-Revision: 1.11 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.14 -->
+<!-- $Revision: 1.11 $ -->
+<!-- EN-Revision: 1.13 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-udiff-assoc" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_udiff_assoc</refname>
<refpurpose>Computa la diferencia entre matrices con un chequeo de índices
adicional, comparando los datos con una llamada de retorno</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>array</type><methodname>array_udiff_assoc</methodname>
- <methodparam><type>array</type><parameter>matriz1</parameter></methodparam>
- <methodparam><type>array</type><parameter>matriz2</parameter></methodparam>
- <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam>
- <methodparam><type>callback</type><parameter>func_comparacion_datos</parameter></methodparam>
- </methodsynopsis>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>array_udiff_assoc</methodname>
+ <methodparam><type>array</type><parameter>matriz1</parameter></methodparam>
+ <methodparam><type>array</type><parameter>matriz2</parameter></methodparam>
+ <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>func_comparacion_datos</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Computa la diferencia de matrices con un chequeo de índices adicional,
+ comparando los datos por medio de una función llamada de retorno.
+ </para>
+ <note>
+ <simpara>
+ Por favor note que esta función sólo analiza una dimensión de una matriz
+ n-dimensional. Por supuesto, puede analizar dimensiones más profundas
+ usando, por ejemplo, <literal>array_udiff_assoc($matriz1[0],
+ $matriz2[0], "func_alguna_comparacion");</literal>.
+ </simpara>
+ </note>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz1</parameter></term>
+ <listitem>
+ <para>
+ La primera matriz.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>matriz2</parameter></term>
+ <listitem>
+ <para>
+ La segunda matriz.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>func_comparacion_datos</parameter></term>
+ <listitem>
+ <para>
+ La función usada como llamada de retorno para la comparación.
+ </para>
+ <para>
+ Para la comparación es usada la llamada de retorno entregada por el
+ usuario. Ésta debe devolver un entero menor que, igual, o mayor que
+ cero si el primer argumento es considerado como menor, igual, o mayor
+ que el segundo, respectivamente.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
<function>array_udiff_assoc</function> devuelve un <type>array</type> que
contiene todos los valores de <parameter>matriz1</parameter> que no están
@@ -28,6 +79,9 @@
de <function>array_diff_assoc</function>, la cual usa una función interna
para la comparación.
</para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>array_udiff_assoc</function></title>
@@ -41,7 +95,7 @@
$this->miembro_privado = $val;
}
- function func_comp_cr($a, $b)
+ static function func_comp_cr($a, $b)
{
if ($a->miembro_privado === $b->miembro_privado) return 0;
return ($a->miembro_privado > $b->miembro_privado)? 1:-1;
@@ -85,30 +139,22 @@
new cr(4)</literal> presente en ambas matrices y por lo tanto no hace
parte de la salida de la función.
</simpara>
- <simpara>
- Para la comparación es usada la llamada de retorno entregada por el
- usuario. Ésta debe devolver un entero menor que, igual, o mayor que cero
- si el primer argumento es considerado como menor, igual, o mayor que el
- segundo, respectivamente.
- </simpara>
- <note>
- <simpara>
- Por favor note que esta función sólo analiza una dimensión de una matriz
- n-dimensional. Por supuesto, puede analizar dimensiones más profundas
- usando, por ejemplo, <literal>array_udiff_assoc($matriz1[0],
- $matriz2[0], "func_alguna_comparacion");</literal>.
- </simpara>
- </note>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Vea también <function>array_diff</function>,
- <function>array_diff_assoc</function>,
- <function>array_diff_uassoc</function>, <function>array_udiff</function>,
- <function>array_udiff_uassoc</function>,
- <function>array_intersect</function>,
- <function>array_intersect_assoc</function>,
- <function>array_uintersect</function>,
- <function>array_uintersect_assoc</function> y
- <function>array_uintersect_uassoc</function>.
+ <simplelist>
+ <member><function>array_diff</function></member>
+ <member><function>array_diff_assoc</function></member>
+ <member><function>array_diff_uassoc</function></member>
+ <member><function>array_udiff</function></member>
+ <member><function>array_udiff_uassoc</function></member>
+ <member><function>array_intersect</function></member>
+ <member><function>array_intersect_assoc</function></member>
+ <member><function>array_uintersect</function></member>
+ <member><function>array_uintersect_assoc</function></member>
+ <member><function>array_uintersect_uassoc</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-udiff-uassoc.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc-es/reference/array/functions/array-udiff-uassoc.xml
diff -u phpdoc-es/reference/array/functions/array-udiff-uassoc.xml:1.9 phpdoc-es/reference/array/functions/array-udiff-uassoc.xml:1.10
--- phpdoc-es/reference/array/functions/array-udiff-uassoc.xml:1.9 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-udiff-uassoc.xml Fri Aug 1 01:29:45 2008
@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.13 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.14 -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.16 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-udiff-uassoc" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_udiff_uassoc</refname>
@@ -9,33 +8,93 @@
adicional, comparando los datos y los índices con una llamada de
retorno</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>array</type><methodname>array_udiff_uassoc</methodname>
- <methodparam><type>array</type><parameter>matriz1</parameter></methodparam>
- <methodparam><type>array</type><parameter>matriz2</parameter></methodparam>
- <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam>
- <methodparam><type>callback</type><parameter>func_comparacion_datos</parameter></methodparam>
- <methodparam><type>callback</type><parameter>func_comparacion_claves</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>array_udiff_uassoc</function> devuelve un <type>array</type>
- que contiene todos los valores de <parameter>matriz1</parameter> que no
- están presentes en ninguno de los otros argumentos. Note que las claves
- son usadas en la comparación, a diferencia de
- <function>array_diff</function> y <function>array_udiff</function>. La
- comparación de los datos de las matrices es realizada usando una llamada
- de retorno entregada por el usuario:
- <parameter>func_comparacion_datos</parameter>. En este sentido, su
- comportamiento es el opuesto del de
- <function>array_diff_assoc</function>, quien usa una función interna para
- la comparación. La comparación de claves (índices) es realizada también
- por la llamada de retorno <parameter>func_comparacion_claves</parameter>.
- Este comportamiento contrasta con lo que hace
- <function>array_udiff_assoc</function>, ya que ésta compara los índices
- usando una función interna.
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>array_udiff_uassoc</methodname>
+ <methodparam><type>array</type><parameter>matriz1</parameter></methodparam>
+ <methodparam><type>array</type><parameter>matriz2</parameter></methodparam>
+ <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>func_comparacion_datos</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>func_comparacion_claves</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Computa la diferencia de matrices con un chequeo de índices adicional,
+ comparando los datos por medio de una función llamada de retorno.
+ </para>
+ <para>
+ Note que las claves son usadas en la comparación, a diferencia de
+ <function>array_diff</function> y <function>array_udiff</function>.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz1</parameter></term>
+ <listitem>
+ <para>
+ La primera matriz.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>matriz2</parameter></term>
+ <listitem>
+ <para>
+ La segunda matriz.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>func_comparacion_datos</parameter></term>
+ <listitem>
+ <para>
+ La función de comparación usada como llamada de retorno.
+ </para>
+ <para>
+ Para la comparación, se usa la llamada de retorno indicada por el
+ usuario. Ésta debe devolver un entero menor que, igual, o mayor que
+ cero si el primer argumento es considerado como menor, igual, o mayor
+ que el segundo, respectivamente.
+ </para>
+ <para>
+ La comparación de los datos de las matrices es realizada usando una
+ llamada de retorno entregada por el usuario:
+ <parameter>func_comparacion_datos</parameter>. En este sentido, su
+ comportamiento es el opuesto al de
+ <function>array_diff_assoc</function>, quien usa una función interna
+ para la comparación.
+ comparison.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>func_comparacion_claves</parameter></term>
+ <listitem>
+ <para>
+ La comparación de claves (índices) es realizada también por la
+ llamada de retorno <parameter>func_comparacion_claves</parameter>.
+ Este comportamiento contrasta con lo que hace
+ <function>array_udiff_assoc</function>, ya que ésta compara los
+ índices usando una función interna.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Devuelve un valor tipo <type>array</type> que contiene todos los valores
+ de <parameter>matriz1</parameter> que no están presentes en ninguno de
+ los otros argumentos.
</para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>array_udiff_uassoc</function></title>
@@ -49,13 +108,13 @@
$this->miembro_privado = $val;
}
- function func_comp_cr($a, $b)
+ static function func_comp_cr($a, $b)
{
if ($a->miembro_privado === $b->miembro_privado) return 0;
return ($a->miembro_privado > $b->miembro_privado)? 1:-1;
}
- function func_comp_claves($a, $b)
+ static function func_comp_claves($a, $b)
{
if ($a === $b) return 0;
return ($a > $b)? 1:-1;
@@ -99,12 +158,9 @@
hace parte de la salida de la función. Tenga en cuenta que debe
especificar 2 llamadas de retorno.
</simpara>
- <simpara>
- Para la comparación, se usa la llamada de retorno indicada por el
- usuario. Ésta debe devolver un entero menor que, igual, o mayor que cero
- si el primer argumento es considerado como menor, igual, o mayor que el
- segundo, respectivamente.
- </simpara>
+ </refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
<note>
<simpara>
Por favor note que esta función únicamente chequea una dimensión de una
@@ -114,16 +170,21 @@
"func_comparacion_claves");</literal>.
</simpara>
</note>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Vea también <function>array_diff</function>,
- <function>array_diff_assoc</function>,
- <function>array_diff_uassoc</function>, <function>array_udiff</function>,
- <function>array_udiff_assoc</function>,
- <function>array_intersect</function>,
- <function>array_intersect_assoc</function>,
- <function>array_uintersect</function>,
- <function>array_uintersect_assoc</function> y
- <function>array_uintersect_uassoc</function>.
+ <simplelist>
+ <member><function>array_diff</function></member>
+ <member><function>array_diff_assoc</function></member>
+ <member><function>array_udiff</function></member>
+ <member><function>array_udiff_assoc</function></member>
+ <member><function>array_intersect</function></member>
+ <member><function>array_intersect_assoc</function></member>
+ <member><function>array_uintersect</function></member>
+ <member><function>array_uintersect_assoc</function></member>
+ <member><function>array_uintersect_uassoc</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-udiff.xml?r1=1.11&r2=1.12&diff_format=u
Index: phpdoc-es/reference/array/functions/array-udiff.xml
diff -u phpdoc-es/reference/array/functions/array-udiff.xml:1.11 phpdoc-es/reference/array/functions/array-udiff.xml:1.12
--- phpdoc-es/reference/array/functions/array-udiff.xml:1.11 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-udiff.xml Fri Aug 1 01:29:45 2008
@@ -1,33 +1,75 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.11 $ -->
-<!-- EN-Revision: 1.12 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.14 -->
+<!-- $Revision: 1.12 $ -->
+<!-- EN-Revision: 1.14 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-udiff" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_udiff</refname>
<refpurpose>Computa la diferencia entre matrices, usando una llamada de
retorno para la comparación de datos</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>array</type><methodname>array_udiff</methodname>
- <methodparam><type>array</type><parameter>matriz1</parameter></methodparam>
- <methodparam><type>array</type><parameter>matriz2</parameter></methodparam>
- <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam>
- <methodparam><type>callback</type><parameter>func_comparacion_datos</parameter></methodparam>
- </methodsynopsis>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>array_udiff</methodname>
+ <methodparam><type>array</type><parameter>matriz1</parameter></methodparam>
+ <methodparam><type>array</type><parameter>matriz2</parameter></methodparam>
+ <methodparam choice="opt"><type>array</type><parameter> ...</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>func_comparacion_datos</parameter></methodparam>
+ </methodsynopsis>
<para>
- <function>array_udiff</function> devuelve una matriz que contiene todos
- los valores de <parameter>matriz1</parameter> que no están presentes en
- ninguno de los otros argumentos. Note que las claves son preservadas.
- Para la comparación de datos, se usa
- <parameter>func_comparacion_datos</parameter>. Esta función debe devolver
- un entero menor que, igual, o mayor que cero si el primer argumento es
- considerado como menor, igual, o mayor que el segundo, respectivamente.
- Esto en contraste a <function>array_diff</function>, la cual usa una
- función interna para la comparación de datos.
+ Computa la diferencia de las matrices usando una función tipo llamada de
+ retorno para la comparación de datos. Esto difiere de
+ <function>array_diff</function>, la cual usa una función interna para la
+ comparación de datos.
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz1</parameter></term>
+ <listitem>
+ <para>
+ La primera matriz.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>matriz2</parameter></term>
+ <listitem>
+ <para>
+ La segunda matriz.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>func_comparacion_datos</parameter></term>
+ <listitem>
+ <para>
+ La función llamada de retorno para la comparación.
+ </para>
+ <para>
+ La llamada de retorno especificada por el usuario es usada para la
+ comparación. Esta función debe devolver un entero menor que, igual, o
+ mayor que cero si el primer argumento es considerado como menor,
+ igual, o mayor que el segundo, respectivamente.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Devuelve una matriz que contiene todos los valores de
+ <parameter>matriz1</parameter> que no están presentes en ninguno de los
+ otros argumentos.
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>array_udiff</function></title>
@@ -41,7 +83,7 @@
$this->miembro_privado = $val;
}
- function func_comp_cr($a, $b)
+ static function func_comp_cr($a, $b)
{
if ($a->miembro_privado === $b->miembro_privado) return 0;
return ($a->miembro_privado > $b->miembro_privado)? 1:-1;
@@ -75,6 +117,9 @@
</screen>
</example>
</para>
+ </refsect1>
+ <refsect1 role="notes">
+ &reftitle.notes;
<note>
<simpara>
Por favor note que esta función sólo analiza una dimensión de una matriz
@@ -83,17 +128,22 @@
"data_compare_func");</literal>.
</simpara>
</note>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Vea también <function>array_diff</function>,
- <function>array_diff_assoc</function>,
- <function>array_diff_uassoc</function>,
- <function>array_udiff_assoc</function>,
- <function>array_udiff_uassoc</function>,
- <function>array_intersect</function>,
- <function>array_intersect_assoc</function>,
- <function>array_uintersect</function>,
- <function>array_uintersect_assoc</function> y
- <function>array_uintersect_uassoc</function>.
+ <simplelist>
+ <member><function>array_diff</function></member>
+ <member><function>array_diff_assoc</function></member>
+ <member><function>array_diff_uassoc</function></member>
+ <member><function>array_udiff_assoc</function></member>
+ <member><function>array_udiff_uassoc</function></member>
+ <member><function>array_intersect</function></member>
+ <member><function>array_intersect_assoc</function></member>
+ <member><function>array_uintersect</function></member>
+ <member><function>array_uintersect_assoc</function></member>
+ <member><function>array_uintersect_uassoc</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-unique.xml?r1=1.7&r2=1.8&diff_format=u
Index: phpdoc-es/reference/array/functions/array-unique.xml
diff -u phpdoc-es/reference/array/functions/array-unique.xml:1.7 phpdoc-es/reference/array/functions/array-unique.xml:1.8
--- phpdoc-es/reference/array/functions/array-unique.xml:1.7 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-unique.xml Fri Aug 1 01:29:45 2008
@@ -1,22 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.16 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.17 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-unique" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_unique</refname>
<refpurpose>Remueve valores duplicados de una matriz</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>array</type><methodname>array_unique</methodname>
- <methodparam><type>array</type><parameter>matriz</parameter></methodparam>
- </methodsynopsis>
- <para>
- <function>array_unique</function> toma la
- <parameter>matriz</parameter> de entrada y devuelve una nueva
- matriz sin los valores repetidos.
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>array</type><methodname>array_unique</methodname>
+ <methodparam><type>array</type><parameter>matriz</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ Toma una <parameter>matriz</parameter> de entrada y devuelve una nueva
+ matriz sin los valores repetidos.
</para>
<para>
Note que las claves son preservadas. <function>array_unique</function>
@@ -36,6 +34,30 @@
Se usará el primer elemento.
</simpara>
</note>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz</parameter></term>
+ <listitem>
+ <para>
+ La matriz de entrada.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Devuelve la matriz filtrada.
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>array_unique</function></title>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/array-walk-recursive.xml?r1=1.6&r2=1.7&diff_format=u
Index: phpdoc-es/reference/array/functions/array-walk-recursive.xml
diff -u phpdoc-es/reference/array/functions/array-walk-recursive.xml:1.6 phpdoc-es/reference/array/functions/array-walk-recursive.xml:1.7
--- phpdoc-es/reference/array/functions/array-walk-recursive.xml:1.6 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/array-walk-recursive.xml Fri Aug 1 01:29:45 2008
@@ -1,48 +1,85 @@
<?xml version='1.0' encoding='utf-8'?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.10 Maintainer: lboshell Status: ready -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.12 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.array-walk-recursive" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>array_walk_recursive</refname>
<refpurpose>Aplicar una función de usuario recursivamente a cada miembro
de una matriz</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>array_walk_recursive</methodname>
<methodparam><type>array</type><parameter role="reference">entrada</parameter></methodparam>
<methodparam><type>callback</type><parameter>nombre_func</parameter></methodparam>
<methodparam choice="opt"><type>mixed</type><parameter>datos_usuario</parameter></methodparam>
</methodsynopsis>
- <simpara>
+ <para>
Aplica la función definida por el usuario
<parameter>nombre_func</parameter> a cada elemento de la matriz
<parameter>entrada</parameter>. Esta función opera de forma recursiva
- sobre matrices profundas. Por lo general,
- <parameter>nombre_func</parameter> recibe dos parámetros. El valor del
- parámetro <parameter>entrada</parameter> es el primero, y la clave/índice
- es el segundo. Si se define el parámetro opcional
- <parameter>datos_usuario</parameter>, éste será pasado como el tercer
- parámetro a la llamada de retorno <parameter>nombre_func</parameter>.
- </simpara>
- <simpara>
+ sobre matrices profundas.
+ </para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>entrada</parameter></term>
+ <listitem>
+ <para>
+ La matriz de entrada.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>nombre_func</parameter></term>
+ <listitem>
+ <para>
+ Por lo general, <parameter>nombre_func</parameter> recibe dos
+ parámetros. El valor del parámetro <parameter>entrada</parameter> es
+ el primero, y la clave/índice es el segundo.
+ </para>
+ <note>
+ <para>
+ Si <parameter>nombre_func</parameter> necesita trabajar con los
+ valores reales de la matriz, especifique el primer parámetro de
+ <parameter>nombre_func</parameter> como una <link
+ linkend="language.references">referencia</link>. Entonces, cualquier
+ cambio realizado sobre esos elementos será efectuado sobre la matriz
+ original misma.
+ </para>
+ </note>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>datos_usuario</parameter></term>
+ <listitem>
+ <para>
+ Si se define el parámetro opcional
+ <parameter>datos_usuario</parameter>, éste será pasado como el tercer
+ parámetro a la llamada de retorno <parameter>nombre_func</parameter>.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+
+
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
&return.success;
- </simpara>
- <note>
- <para>
- Si <parameter>nombre_func</parameter> necesita trabajar con los valores
- reales de la matriz, especifique el primer parámetro de
- <parameter>nombre_func</parameter> como una <link
- linkend="language.references">referencia</link>. Entonces, cualquier
- cambio realizado sobre esos elementos será efectuado sobre la matriz
- original misma.
- </para>
- </note>
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
- <title>Ejemplo de
- <function>array_walk_recursive</function></title>
+ <title>Ejemplo de <function>array_walk_recursive</function></title>
<programlisting role="php">
<![CDATA[
<?php
@@ -72,9 +109,15 @@
</para>
</example>
</para>
- <simpara>
- Vea también <function>array_walk</function>, y &seealso.callback;.
- </simpara>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>array_walk</function></member>
+ <member>&seealso.callback;</member>
+ </simplelist>
+ </para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/natcasesort.xml?r1=1.6&r2=1.7&diff_format=u
Index: phpdoc-es/reference/array/functions/natcasesort.xml
diff -u phpdoc-es/reference/array/functions/natcasesort.xml:1.6 phpdoc-es/reference/array/functions/natcasesort.xml:1.7
--- phpdoc-es/reference/array/functions/natcasesort.xml:1.6 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/natcasesort.xml Fri Aug 1 01:29:45 2008
@@ -1,33 +1,52 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.6 $ -->
-<!-- EN-Revision: 1.11 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.25 -->
+<!-- $Revision: 1.7 $ -->
+<!-- EN-Revision: 1.12 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.natcasesort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>natcasesort</refname>
<refpurpose>Ordena una matriz usando un algoritmo de "orden natural" sin
distinguir mayúsculas de minúsculas</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>bool</type><methodname>natcasesort</methodname>
- <methodparam><type>array</type><parameter role="reference">matriz</parameter></methodparam>
- </methodsynopsis>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>natcasesort</methodname>
+ <methodparam><type>array</type><parameter role="reference">matriz</parameter></methodparam>
+ </methodsynopsis>
+ <para>
+ <function>natcasesort</function> es una versión insensible a
+ mayúsculas/minúsculas de <function>natsort</function>.
+ </para>
<para>
Esta función implementa un algoritmo de ordenamiento que ordena cadenas
alfanuméricas en la forma en que un ser humano lo haría, al mismo tiempo
que conserva las asociaciones clave/valor. Esta propiedad se conoce como
"ordenamiento natural".
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
<para>
- &return.success;
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz</parameter></term>
+ <listitem>
+ <para>
+ La matriz de entrada.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
- <function>natcasesort</function> es una versión de
- <function>natsort</function> que no distingue entre mayúsculas y
- minúsculas.
+ &return.success;
</para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>natcasesort</function></title>
@@ -74,14 +93,21 @@
</screen>
<para>
Para más información vea: la página de <link
- xlink:href="&url.strnatcmp;">Comparación de Cadenas en Orden Natural</link>
- de Martin Pool.
+ xlink:href="&url.strnatcmp;">Comparación de Cadenas en Orden
+ Natural</link> de Martin Pool.
</para>
</example>
</para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Vea también <function>sort</function>, <function>natsort</function>,
- <function>strnatcmp</function>, y <function>strnatcasecmp</function>.
+ <simplelist>
+ <member><function>sort</function></member>
+ <member><function>natsort</function></member>
+ <member><function>strnatcmp</function></member>
+ <member><function>strnatcasecmp</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/natsort.xml?r1=1.7&r2=1.8&diff_format=u
Index: phpdoc-es/reference/array/functions/natsort.xml
diff -u phpdoc-es/reference/array/functions/natsort.xml:1.7 phpdoc-es/reference/array/functions/natsort.xml:1.8
--- phpdoc-es/reference/array/functions/natsort.xml:1.7 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/natsort.xml Fri Aug 1 01:29:45 2008
@@ -1,29 +1,51 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.7 $ -->
-<!-- EN-Revision: 1.15 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.25 -->
+<!-- $Revision: 1.8 $ -->
+<!-- EN-Revision: 1.16 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.natsort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>natsort</refname>
<refpurpose>Ordena una matriz usando un algoritmo de "orden
- natural"</refpurpose> </refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>bool</type><methodname>natsort</methodname>
- <methodparam><type>array</type><parameter role="reference">matriz</parameter></methodparam>
- </methodsynopsis>
+ natural"</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>natsort</methodname>
+ <methodparam><type>array</type><parameter role="reference">matriz</parameter></methodparam>
+ </methodsynopsis>
<para>
Esta función implementa un algoritmo que ordena cadenas alfanuméricas en
la forma en que lo haría un ser humano, al mismo tiempo que conserva las
asociaciones clave/valor. Esta propiedad es conocida como "ordenamiento
natural". Un ejemplo de la diferencia entre éste y el algoritmo
computacional normal de ordenamiento de cadenas (usado en
- <function>sort</function>) puede apreciarse a continuación:
+ <function>sort</function>) puede apreciarse en el ejemplo presentado más
+ adelante.
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz</parameter></term>
+ <listitem>
+ <para>
+ La matriz de entrada.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
&return.success;
</para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>natsort</function></title>
@@ -66,14 +88,20 @@
</screen>
<para>
Para más información vea: la página de <link
- xlink:href="&url.strnatcmp;">Comparación de Cadenas en Orden Natural</link>
- de Martin Pool.
+ xlink:href="&url.strnatcmp;">Comparación de Cadenas en Orden
+ Natural</link> de Martin Pool.
</para>
</example>
</para>
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Vea también <function>natcasesort</function>,
- <function>strnatcmp</function>, y <function>strnatcasecmp</function>.
+ <simplelist>
+ <member><function>natcasesort</function></member>
+ <member><function>strnatcmp</function></member>
+ <member><function>strnatcasecmp</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/range.xml?r1=1.9&r2=1.10&diff_format=u
Index: phpdoc-es/reference/array/functions/range.xml
diff -u phpdoc-es/reference/array/functions/range.xml:1.9 phpdoc-es/reference/array/functions/range.xml:1.10
--- phpdoc-es/reference/array/functions/range.xml:1.9 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/range.xml Fri Aug 1 01:29:45 2008
@@ -1,14 +1,14 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.9 $ -->
-<!-- EN-Revision: 1.18 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
+<!-- $Revision: 1.10 $ -->
+<!-- EN-Revision: 1.19 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.range" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>range</refname>
<refpurpose>Crea una matriz que contiene un rango de
- elementos</refpurpose> </refnamediv>
- <refsect1>
- <title>Descripción</title>
+ elementos</refpurpose>
+ </refnamediv>
+ <refsect1 role="description">
+ &reftitle.description;
<methodsynopsis>
<type>array</type><methodname>range</methodname>
<methodparam><type>mixed</type><parameter>bajo</parameter></methodparam>
@@ -16,22 +16,98 @@
<methodparam choice="opt"><type>number</type><parameter>paso</parameter></methodparam>
</methodsynopsis>
<para>
- <function>rango</function> devuelve una matriz de elementos desde
- <parameter>bajo</parameter> hasta <parameter>alto</parameter>, ambos
- inclusive. Si bajo > alto, la secuencia será del mayor al menor.
- </para>
- <note>
- <title>Nuevo parámetro</title>
- <simpara>
- El parámetro opcional <parameter>paso</parameter> fue añadido en 5.0.0.
- </simpara>
- </note>
- <para>
- Si un valor <parameter>paso</parameter> es dado, éste será usado como el
- incremento entre elementos en la secuencia. <parameter>paso</parameter>
- debería ser definido como un número positivo. Si no se especifica,
- <parameter>paso</parameter> tendrá un valor predeterminado de 1.
+ Crea una matriz que contiene un rango de elementos.
</para>
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
+ <para>
+ <variablelist>
+ <varlistentry>
+ <term><parameter>bajo</parameter></term>
+ <listitem>
+ <para>
+ Valor bajo.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>alto</parameter></term>
+ <listitem>
+ <para>
+ Valor alto.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>paso</parameter></term>
+ <listitem>
+ <para>
+ Si un valor <parameter>paso</parameter> es dado, éste será usado como
+ el incremento entre elementos en la secuencia.
+ <parameter>paso</parameter> debe ser definido como un número
+ positivo. Si no se especifica, <parameter>paso</parameter> tendrá un
+ valor predeterminado de 1.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
+ </para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
+ <para>
+ Devuelve una matriz de elementos desde <parameter>bajo</parameter> hasta
+ <parameter>alto</parameter>, ambos inclusive. Si bajo > alto, la
+ secuencia será del mayor al menor.
+ </para>
+ </refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
+ <para>
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>5.0.0</entry>
+ <entry>
+ Se agregó el parámetro opcional <parameter>paso</parameter>.
+ </entry>
+ </row>
+ <row>
+ <entry>4.1.0 a 4.3.2</entry>
+ <entry>
+ En versiones de PHP desde 4.1.0 hasta 4.3.2,
+ <function>range</function> considera las cadenas numéricas como
+ cadenas y no enteros. En su lugar, ellas serán usadas para
+ secuencias de caracteres. Por ejemplo, <literal>"4242"</literal> es
+ tratado como <literal>"4"</literal>.
+ </entry>
+ </row>
+ <row>
+ <entry>4.1.0</entry>
+ <entry>
+ Antes de PHP 4.1.0, <function>range</function> sólo generaba
+ matrices de enteros incrementales. El soporte para secuencias de
+ caracteres y matrices en decremento fue añadido en 4.1.0. Los
+ valores de secuencia de caracteres esán limitados a una longitud de
+ uno. Si una longitud superior a uno es ingresada, solo se usa el
+ primer caracter.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
+ </para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplos de <function>range</function></title>
@@ -63,27 +139,15 @@
</programlisting>
</example>
</para>
- <note>
- <para>
- Antes de PHP 4.1.0, <function>range</function> sólo generaba matrices de
- enteros incrementales. El soporte para secuencias de caracteres y
- matrices en decremento fue añadido en 4.1.0. Los valores de secuencia de
- caracteres esán limitados a una longitud de uno. Si una longitud
- superior a uno es ingresada, solo se usa el primer caracter.
- </para>
- </note>
- <caution>
- <para>
- En versiones de PHP desde 4.1.0 hasta 4.3.2, <function>range</function>
- considera las cadenas numéricas como cadenas y no enteros. En su lugar,
- ellas serán usadas para secuencias de caracteres. Por ejemplo,
- <literal>"4242"</literal> es tratado como <literal>"4"</literal>.
- </para>
- </caution>
- <para>
- Vea también <function>shuffle</function>,
- <function>array_fill</function>, y <link
- linkend="control-structures.foreach">foreach</link>.
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
+ <para>
+ <simplelist>
+ <member><function>shuffle</function></member>
+ <member><function>array_fill</function></member>
+ <member><link linkend="control-structures.foreach">foreach</link></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
http://cvs.php.net/viewvc.cgi/phpdoc-es/reference/array/functions/usort.xml?r1=1.8&r2=1.9&diff_format=u
Index: phpdoc-es/reference/array/functions/usort.xml
diff -u phpdoc-es/reference/array/functions/usort.xml:1.8 phpdoc-es/reference/array/functions/usort.xml:1.9
--- phpdoc-es/reference/array/functions/usort.xml:1.8 Sat Jun 23 13:25:26 2007
+++ phpdoc-es/reference/array/functions/usort.xml Fri Aug 1 01:29:45 2008
@@ -1,46 +1,91 @@
<?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision: 1.8 $ -->
-<!-- EN-Revision: 1.25 Maintainer: lboshell Status: ready -->
-<!-- splitted from ./en/functions/array.xml, last change in rev 1.2 -->
+<!-- $Revision: 1.9 $ -->
+<!-- EN-Revision: 1.27 Maintainer: lboshell Status: ready -->
<refentry xml:id="function.usort" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>usort</refname>
<refpurpose>Ordena una matriz por sus valores usando una función de
comparación definida por el usuario</refpurpose>
</refnamediv>
- <refsect1>
- <title>Descripción</title>
- <methodsynopsis>
- <type>bool</type><methodname>usort</methodname>
- <methodparam><type>array</type><parameter role="reference">matriz</parameter></methodparam>
- <methodparam><type>callback</type><parameter>funcion_comp</parameter></methodparam>
- </methodsynopsis>
+ <refsect1 role="description">
+ &reftitle.description;
+ <methodsynopsis>
+ <type>bool</type><methodname>usort</methodname>
+ <methodparam><type>array</type><parameter role="reference">matriz</parameter></methodparam>
+ <methodparam><type>callback</type><parameter>funcion_comp</parameter></methodparam>
+ </methodsynopsis>
<para>
Esta función ordenará una matriz por sus valores usando una función de
comparación definida por el usuario. Si la matriz que desea ordenar
necesita ser ordenada mediante ciertos criterios especiales, es buena
idea usar esta función.
</para>
+ <note>
+ <para>
+ Si dos miembros son comparados como iguales, su orden en la matriz
+ resultante es indefinido.
+ </para>
+ </note>
+ ¬e.no-key-association;
+ </refsect1>
+ <refsect1 role="parameters">
+ &reftitle.parameters;
<para>
- La función de comparación debe devolver un entero menor que, igual, o
- mayor que cero si el primer argumento es considerado menor, igual, o
- mayor que el segundo, respectivamente.
+ <variablelist>
+ <varlistentry>
+ <term><parameter>matriz</parameter></term>
+ <listitem>
+ <para>
+ La matriz de entrada.
+ </para>
+ </listitem>
+ </varlistentry>
+ <varlistentry>
+ <term><parameter>funcion_comp</parameter></term>
+ <listitem>
+ <para>
+ La función de comparación debe devolver un entero menor que, igual, o
+ mayor que cero si el primer argumento es considerado menor, igual, o
+ mayor que el segundo, respectivamente.
+ </para>
+ </listitem>
+ </varlistentry>
+ </variablelist>
</para>
+ </refsect1>
+ <refsect1 role="returnvalues">
+ &reftitle.returnvalues;
<para>
- <note>
- <para>
- Si dos miembros son comparados como iguales, su orden en la matriz
- resultante es indefinido. Hasta PHP 4.0.6, las funciones definidas por
- el usuario mantenían el orden original para esos elementos, pero con el
- nuevo algoritmo de ordenamiento introducido en 4.1.0 este ya no es el
- caso, ya que no hay forma de hacerlo de manera eficiente.
- </para>
- </note>
+ &return.success;
</para>
- ¬e.no-key-association;
+ </refsect1>
+ <refsect1 role="changelog">
+ &reftitle.changelog;
<para>
- &return.success;
+ <informaltable>
+ <tgroup cols="2">
+ <thead>
+ <row>
+ <entry>&Version;</entry>
+ <entry>&Description;</entry>
+ </row>
+ </thead>
+ <tbody>
+ <row>
+ <entry>4.1.0</entry>
+ <entry>
+ Se introdujo un nuevo algoritmo. La función
+ <parameter>funcion_comp</parameter> no mantiene el orden original
+ para los elementos que son comparados como iguales.
+ </entry>
+ </row>
+ </tbody>
+ </tgroup>
+ </informaltable>
</para>
+ </refsect1>
+ <refsect1 role="examples">
+ &reftitle.examples;
<para>
<example>
<title>Ejemplo de <function>usort</function></title>
@@ -92,7 +137,7 @@
<programlisting role="php">
<![CDATA[
<?php
-function cmp($a, $b)
+function cmp($a, $b)
{
return strcmp($a["fruta"], $b["fruta"]);
}
@@ -124,7 +169,6 @@
</screen>
</example>
</para>
-
<para>
<example>
<title>
@@ -137,13 +181,13 @@
class ObjPrueba {
var $nombre;
- function ObjPrueba($nombre)
+ function ObjPrueba($nombre)
{
$this->nombre = $nombre;
}
/* Esta es la función estática de comparación: */
- function cmp_obj($a, $b)
+ static function cmp_obj($a, $b)
{
$al = strtolower($a->nombre);
$bl = strtolower($b->nombre);
@@ -176,12 +220,20 @@
</screen>
</example>
</para>
-
+ </refsect1>
+ <refsect1 role="seealso">
+ &reftitle.seealso;
<para>
- Vea también <function>uasort</function>, <function>uksort</function>,
- <function>sort</function>, <function>asort</function>,
- <function>arsort</function>,<function>ksort</function>,
- <function>natsort</function>, and <function>rsort</function>.
+ <simplelist>
+ <member><function>uasort</function></member>
+ <member><function>uksort</function></member>
+ <member><function>sort</function></member>
+ <member><function>asort</function></member>
+ <member><function>arsort</function></member>
+ <member><function>ksort</function></member>
+ <member><function>natsort</function></member>
+ <member><function>rsort</function></member>
+ </simplelist>
</para>
</refsect1>
</refentry>
| Navigate in group php.doc.es at sever news.php.net | |
| Previous | Next |
| © No Copyright You are free to use Anything |
Site Maintained by PHP Developer
Powered By PHP Consultants |