Skip to content

Commit

Permalink
Browse files Browse the repository at this point in the history
Clarify wording in splice() description
  • Loading branch information
Geoffrey Broadwell committed Mar 3, 2012
1 parent f8d2de3 commit 86b688a
Showing 1 changed file with 6 additions and 6 deletions.
12 changes: 6 additions & 6 deletions S32-setting-library/Containers.pod
Expand Up @@ -19,8 +19,8 @@ DRAFT: Synopsis 32: Setting Library - Containers.pod

Created: 19 Feb 2009 extracted from S29-functions.pod

Last Modified: 8 Jun 2011
Version: 29
Last Modified: 2 Mar 2012
Version: 30

The document is a draft.

Expand Down Expand Up @@ -692,11 +692,11 @@ new (and potentially empty) list. This operation can shorten or lengthen
the target array.

C<$offset> is the index of the array element to start with. A WhateverCode
whose argument is the distance from the end of the C<@array> may also be used.
whose argument is the number of elements in the C<@array> may also be used.

C<$size> is the number of elements to remove from C<@array>. A WhateverCode
similar to C<$offset> may be used instead (note that this specifies a position,
not an actual number of elements).
not an actual number of elements to remove).

The slurpy list of values (if any) is then inserted at C<$offset>.

Expand All @@ -718,8 +718,8 @@ expected in either list or item context.
C<$offset> and C<$size> will be treated as C<Int>. The function fails if
either parameter is negative, or undefined.

Either of C<$offset> or C<$size> may be specified relative to the end of the
array using a WhateverCode whose argument will be the position of the end of
Either of C<$offset> or C<$size> may be specified relative to the length of the
array using a WhateverCode whose argument will be the number of elements in
the array.

While it is illegal for the offset to be larger than the size of
Expand Down

0 comments on commit 86b688a

Please sign in to comment.