diff options
| author | Matthew Draper <matthew@trebex.net> | 2018-08-15 03:01:05 +0930 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2018-08-15 03:01:05 +0930 |
| commit | 7fa2f539fa2a7a1ebb5086023091983ce0d810d9 (patch) | |
| tree | edb47a67fd44ab9a6fad7a38239094f2146fdad9 /guides | |
| parent | ffc4703f22888dce0394fe0ab524a9e6cdc3c7e5 (diff) | |
| parent | b71abb3bb8cd177d1d3fceec88f54b505d616887 (diff) | |
| download | rails-7fa2f539fa2a7a1ebb5086023091983ce0d810d9.tar.gz rails-7fa2f539fa2a7a1ebb5086023091983ce0d810d9.tar.bz2 rails-7fa2f539fa2a7a1ebb5086023091983ce0d810d9.zip | |
Merge pull request #33137 from bogdanvlviv/add-array-extract-method
Add `Array#extract!`
Diffstat (limited to 'guides')
| -rw-r--r-- | guides/source/active_support_core_extensions.md | 13 |
1 files changed, 13 insertions, 0 deletions
diff --git a/guides/source/active_support_core_extensions.md b/guides/source/active_support_core_extensions.md index dfd21915b0..f9fc7044ba 100644 --- a/guides/source/active_support_core_extensions.md +++ b/guides/source/active_support_core_extensions.md @@ -2156,6 +2156,19 @@ This method is an alias of `Array#<<`. NOTE: Defined in `active_support/core_ext/array/prepend_and_append.rb`. +### Extracting + +The method `extract!` removes and returns the elements for which the block returns a true value. +If no block is given, an Enumerator is returned instead. + +```ruby +numbers = [0, 1, 2, 3, 4, 5, 6, 7, 8, 9] +odd_numbers = numbers.extract! { |number| number.odd? } # => [1, 3, 5, 7, 9] +numbers # => [0, 2, 4, 6, 8] +``` + +NOTE: Defined in `active_support/core_ext/array/extract.rb`. + ### Options Extraction When the last argument in a method call is a hash, except perhaps for a `&block` argument, Ruby allows you to omit the brackets: |