diff options
| author | Abigail <abigail@abigail.be> | 2002-06-11 19:46:01 -0700 |
|---|---|---|
| committer | Jarkko Hietaniemi <jhi@iki.fi> | 2002-06-12 12:33:33 +0000 |
| commit | 41d39f3045c8f89e3965ec33f17acd39dcfa09eb (patch) | |
| tree | 8b4d2f92bdb29cbbf85ddcf71cecac9268a65c6a /pod | |
| parent | 9a2ac92cbea58b239c3b384381e55d9d780a2bee (diff) | |
| download | perl-41d39f3045c8f89e3965ec33f17acd39dcfa09eb.tar.gz | |
Re: Change sort in scalar context behavior.
Message-ID: <20020612024601.A8524@ucan.foad.org>
p4raw-id: //depot/perl@17202
Diffstat (limited to 'pod')
| -rw-r--r-- | pod/perlfunc.pod | 23 |
1 files changed, 13 insertions, 10 deletions
diff --git a/pod/perlfunc.pod b/pod/perlfunc.pod index c85d43be64..46b2be47c9 100644 --- a/pod/perlfunc.pod +++ b/pod/perlfunc.pod @@ -4483,16 +4483,19 @@ sockets but not socketpair. =item sort LIST -Sorts the LIST and returns the sorted list value. If SUBNAME or BLOCK -is omitted, C<sort>s in standard string comparison order. If SUBNAME is -specified, it gives the name of a subroutine that returns an integer -less than, equal to, or greater than C<0>, depending on how the elements -of the list are to be ordered. (The C<< <=> >> and C<cmp> -operators are extremely useful in such routines.) SUBNAME may be a -scalar variable name (unsubscripted), in which case the value provides -the name of (or a reference to) the actual subroutine to use. In place -of a SUBNAME, you can provide a BLOCK as an anonymous, in-line sort -subroutine. +In list context, this sorts the LIST and returns the sorted list value. +In scalar context, sort doesn't do anything and an undefined value is +returned. + +If SUBNAME or BLOCK is omitted, C<sort>s in standard string comparison +order. If SUBNAME is specified, it gives the name of a subroutine +that returns an integer less than, equal to, or greater than C<0>, +depending on how the elements of the list are to be ordered. (The C<< +<=> >> and C<cmp> operators are extremely useful in such routines.) +SUBNAME may be a scalar variable name (unsubscripted), in which case +the value provides the name of (or a reference to) the actual +subroutine to use. In place of a SUBNAME, you can provide a BLOCK as +an anonymous, in-line sort subroutine. If the subroutine's prototype is C<($$)>, the elements to be compared are passed by reference in C<@_>, as for a normal subroutine. This is |