array.c: [DOC] improve Array#{select,select!,keep_if} docs

git-svn-id: svn+ssh://ci.ruby-lang.org/ruby/trunk@65527 b2dd03c8-39d4-4d8f-98ff-823fe69b080e
This commit is contained in:
stomar 2018-11-04 11:39:28 +00:00
parent f167ff47a6
commit bd20f031db

24
array.c
View File

@ -3145,10 +3145,10 @@ rb_ary_values_at(int argc, VALUE *argv, VALUE ary)
*
* If no block is given, an Enumerator is returned instead.
*
* [1,2,3,4,5].select {|num| num.even? } #=> [2, 4]
* [1,2,3,4,5].select {|num| num.even? } #=> [2, 4]
*
* a = %w{ a b c d e f }
* a.select {|v| v =~ /[aeiou]/} #=> ["a", "e"]
* a = %w[ a b c d e f ]
* a.select {|v| v =~ /[aeiou]/ } #=> ["a", "e"]
*
* See also Enumerable#select.
*/
@ -3215,8 +3215,8 @@ select_bang_ensure(VALUE a)
/*
* call-seq:
* ary.select! {|item| block } -> ary or nil
* ary.select! -> Enumerator
* ary.select! {|item| block } -> ary or nil
* ary.select! -> Enumerator
*
* Invokes the given block passing in successive elements from +self+,
* deleting elements for which the block returns a +false+ value.
@ -3225,10 +3225,9 @@ select_bang_ensure(VALUE a)
*
* If changes were made, it will return +self+, otherwise it returns +nil+.
*
* See also Array#keep_if
*
* If no block is given, an Enumerator is returned instead.
*
* See also Array#keep_if.
*/
static VALUE
@ -3250,14 +3249,15 @@ rb_ary_select_bang(VALUE ary)
* ary.keep_if -> Enumerator
*
* Deletes every element of +self+ for which the given block evaluates to
* +false+.
*
* See also Array#select!
* +false+, and returns +self+.
*
* If no block is given, an Enumerator is returned instead.
*
* a = %w{ a b c d e f }
* a.keep_if {|v| v =~ /[aeiou]/} #=> ["a", "e"]
* a = %w[ a b c d e f ]
* a.keep_if {|v| v =~ /[aeiou]/ } #=> ["a", "e"]
* a #=> ["a", "e"]
*
* See also Array#select!.
*/
static VALUE