archived-doc-es/reference/array/functions/sort.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 32952c4ddc71070da5c2e0344ef50f5afef08ae1 Maintainer: seros Status: ready -->
<!-- Reviewed: yes Maintainer: seros -->
<refentry xml:id="function.sort" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>sort</refname>
  <refpurpose>Ordena un array</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>sort</methodname>
   <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam>
   <methodparam choice="opt"><type>int</type><parameter>sort_flags</parameter><initializer>SORT_REGULAR</initializer></methodparam>
  </methodsynopsis>
  <para>
   Esta función ordena un array. Los elementos estarán ordenados de
   menor a mayor cuando la función haya terminado.   
  </para>
  &note.sort-unstable;
 </refsect1>
 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>array</parameter></term>
     <listitem>
      <para>
       El array de entrada.
      </para>
     </listitem>
    </varlistentry>
    <varlistentry>
     <term><parameter>sort_flags</parameter></term>
     <listitem>
      <para>
       El segundo parámetro opcional <parameter>sort_flags</parameter>
       puede ser usado para modificar el modo de ordenación usando estos valores:
      </para>
      <para>
       Tipos de ordenación:
       <itemizedlist>
        <listitem>
         <simpara><constant>SORT_REGULAR</constant> - compara elementos normalmente
          (no cambia los tipos)</simpara>
        </listitem>
        <listitem>
         <simpara><constant>SORT_NUMERIC</constant> - compara elementos de forma numérica</simpara>
        </listitem>
        <listitem>
         <simpara><constant>SORT_STRING</constant> - compara elementos como cadenas</simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>SORT_LOCALE_STRING</constant> - compara elementos como 
          cadenas, basándose en la configuración regional en uso. Utiliza la configuración regional,
          la cual puede cambiarse usando <function>setlocale</function>.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>SORT_NATURAL</constant> - compara elementos como cadenas
          usando el "orden natural" de la misma forma que <function>natsort</function>.
         </simpara>
        </listitem>
        <listitem>
         <simpara>
          <constant>SORT_FLAG_CASE</constant> - se puede combinar
          (OR a nivel de bits) con
          <constant>SORT_STRING</constant> o <constant>SORT_NATURAL</constant>
          para ordenar cadenas de forma insensible a mayúsculas/minúsculas.
         </simpara>
        </listitem>
       </itemizedlist>
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>
 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   &return.success;
  </para>
 </refsect1>
 <refsect1 role="changelog">
  &reftitle.changelog;
  <informaltable>
   <tgroup cols="2">
    <thead>
     <row>
      <entry>&Version;</entry>
      <entry>&Description;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>5.4.0</entry>
      <entry>
       Se añadió el soporte para <constant>SORT_NATURAL</constant> y
       <constant>SORT_FLAG_CASE</constant> como <parameter>sort_flags</parameter>
      </entry>
     </row>
     <row>
      <entry>5.0.2</entry>
      <entry>
       Se añadió <constant>SORT_LOCALE_STRING</constant>
      </entry>
     </row>
    </tbody>
   </tgroup>
  </informaltable>
 </refsect1>
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>sort</function></title>
    <programlisting role="php">
<![CDATA[
<?php

$frutas = array("limón", "naranja", "banana", "albaricoque");
sort($frutas);
foreach ($frutas as $clave => $valor) {
    echo "frutas[" . $clave . "] = " . $valor . "\n";
}

?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
frutas[0] = albaricoque
frutas[1] = banana
frutas[2] = limón
frutas[3] = naranja
]]>
    </screen>
   </example>
  </para>
  <para>
   Las frutas han sido ordenadas en orden alfabético.
  </para>
  <para>
   <example>
    <title>Ejemplo de <function>sort</function> usando la ordenación insensible a mayúsculas/minúsculas
     natural</title>
    <programlisting role="php">
<![CDATA[
<?php

$frutas = array(
    "Naranja1", "naranja2", "Naranja3", "naranja20"
);
sort($frutas, SORT_NATURAL | SORT_FLAG_CASE);
foreach ($frutas as $clave => $valor) {
    echo "frutas[" . $clave . "] = " . $valor . "\n";
}

?>
]]>
    </programlisting>
    &example.outputs;
    <screen>
<![CDATA[
frutas[0] = Naranja1
frutas[1] = naranja2
frutas[2] = Naranja3
frutas[3] = naranja20
]]>
    </screen>
   </example>
  </para>
  <para>
   Las frutas han sido ordenadas de la misma forma que <function>natcasesort</function>.
  </para>
 </refsect1>
 <refsect1 role="notes">
  &reftitle.notes;
  &note.no-key-association;
  <note>
   <simpara>
    Como la mayoría de funciones de ordenación de PHP, <function>sort</function> utiliza una
    implementación de <link
    xlink:href="&url.wiki.quicksort;">Quicksort</link>.
    El pivote es elegido en la mitad de la partición resultando en un tiempo óptimo
    para los arrays ya ordenados. Aunque esto es un detalle de implementación
    con el que no debería contar.
   </simpara>
  </note>
  <warning>
   <simpara>
    Se ha de tener cuidado cuando se ordenen arrays con valores de tipos mixtos ya que    
    <function>sort</function> puede producir resultados impredecibles.
   </simpara>
  </warning>
 </refsect1>
 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>asort</function></member>
    <member>&seealso.array.sorting;</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
-->