[DOC] Tweaks for Array#none? (#11788)

This commit is contained in:
Burdette Lamar 2024-10-04 15:11:10 -05:00 committed by GitHub
parent b57bbf774f
commit 87169dd435
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
Notes: git 2024-10-04 20:11:28 +00:00
Merged-By: peterzhu2118 <peter@peterzhu.ca>

33
array.c
View File

@ -7912,34 +7912,35 @@ rb_ary_all_p(int argc, VALUE *argv, VALUE ary)
/*
* call-seq:
* array.none? -> true or false
* array.none? {|element| ... } -> true or false
* array.none?(obj) -> true or false
* none? -> true or false
* none?(object) -> true or false
* none? {|element| ... } -> true or false
*
* Returns +true+ if no element of +self+ meet a given criterion.
* Returns +true+ if no element of +self+ meets a given criterion, +false+ otherwise.
*
* With no block given and no argument, returns +true+ if +self+ has no truthy elements,
* +false+ otherwise:
*
* [nil, false].none? # => true
* [nil, false].none? # => true
* [nil, 0, false].none? # => false
* [].none? # => true
* [].none? # => true
*
* With a block given and no argument, calls the block with each element in +self+;
* With argument +object+ given, returns +false+ if for any element +element+,
* <tt>object === element</tt>; +true+ otherwise:
*
* ['food', 'drink'].none?(/bar/) # => true
* ['food', 'drink'].none?(/foo/) # => false
* [].none?(/foo/) # => true
* [0, 1, 2].none?(3) # => true
* [0, 1, 2].none?(1) # => false
*
* With a block given, calls the block with each element in +self+;
* returns +true+ if the block returns no truthy value, +false+ otherwise:
*
* [0, 1, 2].none? {|element| element > 3 } # => true
* [0, 1, 2].none? {|element| element > 1 } # => false
*
* If argument +obj+ is given, returns +true+ if <tt>obj.===</tt> no element, +false+ otherwise:
*
* ['food', 'drink'].none?(/bar/) # => true
* ['food', 'drink'].none?(/foo/) # => false
* [].none?(/foo/) # => true
* [0, 1, 2].none?(3) # => true
* [0, 1, 2].none?(1) # => false
*
* Related: Enumerable#none?
* Related: see {Methods for Querying}[rdoc-ref:Array@Methods+for+Querying].
*/
static VALUE