Project

General

Profile

Actions

Misc #10469

closed

Documented return value for Array#each

Added by jaredbeck (Jared Beck) over 9 years ago. Updated about 9 years ago.

Status:
Closed
Assignee:
[ruby-core:66063]

Description

This is a minor documentation suggestion.

When given a block, Array#each returns self.

[1,2,3].each { |x| 'banana' }
#=> [1, 2, 3]

However, this is not obvious (to me) from the documentation.

The documented method signature is each { |item| block } → ary. Perhaps most people would understand that ary is self, but I think it could be more clear.

Perhaps something like the following (change in bold):

Calls the given block once for each element in self, passing that element as a parameter, and returning the array itself.

Thanks!


Files

array_each_return_docs.patch (927 Bytes) array_each_return_docs.patch jaredbeck (Jared Beck), 11/03/2014 06:57 AM
Actions

Also available in: Atom PDF

Like0
Like0Like0