cvs: phpdoc-fr /reference/array/functions natcasesort.xml natsort.xml

From: Date: Fri, 27 Feb 2004 07:53:20 +0000
Subject: cvs: phpdoc-fr /reference/array/functions natcasesort.xml natsort.xml
Groups: php.doc.fr 
Request: Send a blank email to doc-fr+get-1881@lists.php.net to get a copy of this message
poz Fri Feb 27 02:53:20 2004 EDT Modified files: /phpdoc-fr/reference/array/functions natcasesort.xml natsort.xml Log: Sync with EN http://cvs.php.net/diff.php/phpdoc-fr/reference/array/functions/natcasesort.xml?r1=1.10&r2=1.11&ty=u Index: phpdoc-fr/reference/array/functions/natcasesort.xml diff -u phpdoc-fr/reference/array/functions/natcasesort.xml:1.10 phpdoc-fr/reference/array/functions/natcasesort.xml:1.11 --- phpdoc-fr/reference/array/functions/natcasesort.xml:1.10 Tue Feb 24 13:08:11 2004 +++ phpdoc-fr/reference/array/functions/natcasesort.xml Fri Feb 27 02:53:20 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.10 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/array.xml, last change in rev 1.30 --> -<!-- last change to 'natcasesort' in en/ tree in rev 1.25 --> +<!-- $Revision: 1.11 $ --> +<!-- EN-Revision: 1.5 Maintainer: poz Status: ready --> <refentry id="function.natcasesort"> <refnamediv> <refname>natcasesort</refname> @@ -13,24 +10,72 @@ </refnamediv> <refsect1> <title>Description</title> - <methodsynopsis> - <type>void</type><methodname>natcasesort</methodname> - <methodparam><type>array</type><parameter>array</parameter></methodparam> - </methodsynopsis> + <methodsynopsis> + <type>void</type><methodname>natcasesort</methodname> + <methodparam><type>array</type><parameter>array</parameter></methodparam> + </methodsynopsis> <para> <function>natcasesort</function> implémente un algorithme de tri qui traite les chaînes alpha-numériques comme - un être humain : c'est ce qui est appelé l'"ordre naturel". + un être humain tout en conservant la relation clé/valeur. C'est ce qui est + appelé l'"ordre naturel". </para> <para> <function>natcasesort</function> est la version insensible à la - casse de <function>natsort</function>. Voir aussi - <function>natsort</function> pour un exemple illustré. + casse de <function>natsort</function>. </para> <para> - Pour plus de détails, rendez-vous sur le site de - Martin Pool : - <ulink url="&url.strnatcmp;"><literal>Natural Order String Comparison</literal></ulink>. + <example> + <title>Exemple avec <function>natcasesort</function></title> + <programlisting role="php"> +<![CDATA[ +<?php +$array1 = $array2 = array('IMG0.png', 'img12.png', 'img10.png', +'img2.png', 'img1.png', 'IMG3.png'); + +sort($array1); +echo "Standard sorting\n"; +print_r($array1); + +natcasesort($array2); +echo "\nNatural order sorting (case-insensitive)\n"; +print_r($array2); +?> +]]> + </programlisting> + <para> + Le code ci-dessus va afficher : + </para> + <screen> +<![CDATA[ +Standard sorting +Array +( + [0] => IMG0.png + [1] => IMG3.png + [2] => img1.png + [3] => img10.png + [4] => img12.png + [5] => img2.png +) + +Natural order sorting (case-insensitive) +Array +( + [0] => IMG0.png + [4] => img1.png + [3] => img2.png + [5] => IMG3.png + [2] => img10.png + [1] => img12.png +) +]]> + </screen> + <para> + Pour plus de détails, rendez-vous sur le site de Martin Pool : + <ulink url="&url.strnatcmp;">Natural Order String Comparison</ulink> + </para> + </example> </para> <para> Voir aussi http://cvs.php.net/diff.php/phpdoc-fr/reference/array/functions/natsort.xml?r1=1.12&r2=1.13&ty=u Index: phpdoc-fr/reference/array/functions/natsort.xml diff -u phpdoc-fr/reference/array/functions/natsort.xml:1.12 phpdoc-fr/reference/array/functions/natsort.xml:1.13 --- phpdoc-fr/reference/array/functions/natsort.xml:1.12 Tue Feb 24 13:08:11 2004 +++ phpdoc-fr/reference/array/functions/natsort.xml Fri Feb 27 02:53:20 2004 @@ -1,9 +1,6 @@ <?xml version="1.0" encoding="iso-8859-1"?> -<!-- $Revision: 1.12 $ --> -<!-- EN-Revision: 1.1 Maintainer: nobody Status: partial --> - -<!-- splitted from ./fr/functions/array.xml, last change in rev 1.30 --> -<!-- last change to 'natsort' in en/ tree in rev 1.25 --> +<!-- $Revision: 1.13 $ --> +<!-- EN-Revision: 1.9 Maintainer: poz Status: ready --> <refentry id="function.natsort"> <refnamediv> <refname>natsort</refname> @@ -20,8 +17,8 @@ <para> <function>natsort</function> implémente un algorithme de tri qui traite les chaînes alpha-numériques - comme un être humain : c'est ce qui est appelé - l'"ordre naturel". Un exemple de la différence de + comme un être humain tout en conservant la relation clé/valeur. C'est ce qui + est appelé l'"ordre naturel". Un exemple de la différence de traitement entre un tel algorithme et un algorithme de tri de chaînes (comme lorsqu'on utilise <function>sort</function>) est illustré ci-dessous : @@ -74,12 +71,6 @@ </para> </example> </para> - <note> - <para> - Si vous souhaitez conserver la relation clé/valeur, - utilisez plutôt <literal>uasort($arr, 'strnatcmp')</literal>. - </para> - </note> <para> Voir aussi <function>natcasesort</function>,

« previous php.doc.fr (#1881) next »