Extra examples for 'sort'
authorBram <p5p@perl.wizbit.be>
Sun, 28 Jun 2009 10:38:03 +0000 (12:38 +0200)
committerDavid Mitchell <davem@iabyn.com>
Tue, 30 Jun 2009 12:03:49 +0000 (13:03 +0100)
(cherry picked from commit a9320c62d9034275ce0ce1fa301011823fbbe2a4)

pod/perlfunc.pod

index 405d2b5..ddae4ed 100644 (file)
@@ -5356,6 +5356,24 @@ Examples:
     use sort '_mergesort';  # note discouraging _
     @new = sort { substr($a, 3, 5) cmp substr($b, 3, 5) } @old;
 
+
+Warning: Care is required when sorting the list returned from a function.
+
+If you want to sort returned by the function call: find_records(@key) then
+you can use:
+    @contact = sort { $a cmp $b } find_records @key;
+    @contact = sort +find_records(@key);
+    @contact = sort &find_records(@key);
+    @contact = sort(find_records(@key));
+
+If instead you want to sort the array @key with the comparison routine
+find_records then you can use:
+    @contact = sort { find_records() } @key;
+    @contact = sort find_records(@key);
+    @contact = sort(find_records @key);
+    @contact = sort(find_records (@key));
+
+
 If you're using strict, you I<must not> declare $a
 and $b as lexicals.  They are package globals.  That means
 if you're in the C<main> package and type