svn: /phpdoc/en/trunk/reference/array/functions/ natsort.xml
| From: | Philip Olson | 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">