svn: /phpdoc/en/trunk/reference/array/functions/ natsort.xml

From: Date: Tue, 18 May 2010 01:43:37 +0000
Subject: svn: /phpdoc/en/trunk/reference/array/functions/ natsort.xml
Groups: php.doc.cvs 
Request: Send a blank email to doc-cvs+get-6666@lists.php.net to get a copy of this message
philip Tue, 18 May 2010 01:43:37 +0000 Revision: http://svn.php.net/viewvc?view=revision&revision=299436 Log: Added note about 5.2.10 '0' padding change, and added a bunch of gotcha-like examples as expressed in several user notes Changed paths: U phpdoc/en/trunk/reference/array/functions/natsort.xml Modified: phpdoc/en/trunk/reference/array/functions/natsort.xml =================================================================== --- phpdoc/en/trunk/reference/array/functions/natsort.xml 2010-05-17 20:22:20 UTC (rev 299435) +++ phpdoc/en/trunk/reference/array/functions/natsort.xml 2010-05-18 01:43:37 UTC (rev 299436) @@ -40,11 +40,34 @@ &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.2.10</entry> + <entry> + Zero padded numeric strings (e.g., '00005') now essentially ignore the 0 padding. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> <example> - <title><function>natsort</function> example</title> + <title><function>natsort</function> examples demonstrating basic usage</title> <programlisting role="php"> <![CDATA[ <?php @@ -88,6 +111,116 @@ page. </para> </example> + <example> + <title><function>natsort</function> examples demonstrating potential gotchas</title> + <programlisting role="php"> +<![CDATA[ +<?php +echo "Negative numbers\n"; +$negative = array('-5','3','-2','0','-1000','9','1'); +print_r($negative); +natsort($negative); +print_r($negative); + +echo "Zero padding\n"; +$zeros = array('09', '8', '10', '009', '011', '0'); +print_r($zeros); +natsort($zeros); +print_r($zeros); + +echo "Other characters interfering\n"; +$images_oops = array('image_1.jpg','image_12.jpg', 'image_21.jpg', 'image_4.jpg'); +print_r($images_oops); +natsort($images_oops); +print_r($images_oops); + +echo "Sort by keys\n"; +$smoothie = array('orange' => 1, 'apple' => 1, 'yogurt' => 4, 'banana' => 4); +print_r($smoothie); +uksort( $smoothie, 'strnatcmp'); +print_r($smoothie); +?> +]]> + </programlisting> + &example.outputs; + <screen> +<![CDATA[ +Negative numbers +Array +( + [0] => -5 + [1] => 3 + [2] => -2 + [3] => 0 + [4] => -1000 + [5] => 9 + [6] => 1 +) +Array +( + [2] => -2 + [0] => -5 + [4] => -1000 + [3] => 0 + [6] => 1 + [1] => 3 + [5] => 9 +) + +Zero padding +Array +( + [0] => 09 + [1] => 8 + [2] => 10 + [3] => 009 + [4] => 011 + [5] => 0 +) +Array +( + [5] => 0 + [1] => 8 + [3] => 009 + [0] => 09 + [2] => 10 + [4] => 011 +) + +Other characters interfering +Array +( + [0] => image_1.jpg + [1] => image_12.jpg + [2] => image_21.jpg + [3] => image_4.jpg +) +Array +( + [0] => image_1.jpg + [3] => image_4.jpg + [1] => image_12.jpg + [2] => image_21.jpg +) + +Sort by keys +Array +( + [orange] => 1 + [apple] => 1 + [yogurt] => 4 + [banana] => 4 +) +Array +( + [apple] => 1 + [banana] => 4 + [orange] => 1 + [yogurt] => 4 +) +]]> + </screen> + </example> </para> </refsect1> <refsect1 role="seealso">

« previous php.doc.cvs (#6666) next »