Permalink
Browse files

Mark ".exists" and ".delete" as deprecated, use ":exists" and ":delet…

…e" instead
  • Loading branch information...
1 parent 069bda8 commit 126dd3b3cca08f6e94bba9cc409520078c35088d @lizmat lizmat committed Sep 30, 2013
Showing with 16 additions and 38 deletions.
  1. +16 −38 S32-setting-library/Containers.pod
@@ -685,37 +685,22 @@ failure.)
Returns the length of the array counted in elements.
-=item delete
+=item delete (DEPRECATED)
- method delete (@array : Int $index --> $value ) is export
-
-Sets the specified Array element to the default value of the Array.
-
-Deleted elements at the end of an Array shorten the length of the Array,
-unless doing so would violate an C<is shape()> definition.
-
-This is considered to be an internal method. The normal way to delete is by
-applying a C<:delete> adverb to any subscripting operation.
-
-Returns the value previously held in deleted location.
+The "delete" method is considered to be a deprecated internal method: the
+normal way to test for existence is to apply the C<:delete> adverb to a
+subscripting operation.
=item :delete
This adverb may be applied to any subscripting operation. The operation
returns the elements normally, but reads them out destructively.
-=item exists
-
- method exists (@array: Int $index --> Bool )
-
-True if the specified Array element has been assigned to with a value different
-from the default value of the Array.
+=item exists (DEPRECATED)
-Supplying a different number of indices than invocant has dimensions is
-an error.
-
-This is considered to be an internal method: the normal way to test for
-existence is to apply the C<:exists> adverb to a subscripting operation.
+The "exists" method is considered to be a deprecated internal method: the
+normal way to test for existence is to apply the C<:exists> adverb to a
+subscripting operation.
=item :exists
@@ -899,29 +884,22 @@ The following are defined in the C<Hash> class.
=over 4
-=item delete
-
- method delete ( %hash: $key --> $value ) is export
-
-Remove the specified element from the hash, and return its value.
+=item delete (DEPRECATED)
-This is considered to be an internal method: the normal way to delete is by
-applying a C<:delete> adverb to any subscripting operation.
+The "delete" method is considered to be a deprecated internal method: the
+normal way to test for existence is to apply the C<:delete> adverb to a
+subscripting operation.
=item :delete
This adverb may be applied to any subscripting operation. The operation
returns the elements normally, but reads them out destructively.
-=item exists
-
- method exists ( %hash: $key --> Bool )
-
-True if the specified element has been assigned to. This need not the be same
-as being defined.
+=item exists (DEPRECATED)
-This is considered to be an internal method: the normal way to test for
-existence is to apply the C<:exists> adverb to a subscripting operation.
+The "exists" method is considered to be a deprecated internal method: the
+normal way to test for existence is to apply the C<:exists> adverb to a
+subscripting operation.
=item :exists

0 comments on commit 126dd3b

Please sign in to comment.