1berry/ruby
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

[DOC] Doc for Hash#transform_values!

Browse Source
This commit is contained in:
Burdette Lamar 2025-03-23 10:09:08 -05:00 committed by GitHub
parent 383af53a56
commit 12b2b577b7
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
Notes: git 2025-03-23 15:09:25 +00:00 
Merged: https://github.com/ruby/ruby/pull/12944

Merged-By: peterzhu2118 <peter@peterzhu.ca>
1 changed files with 13 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

20
hash.c
View File

@ -3435,18 +3435,24 @@ rb_hash_transform_values(VALUE hash)
/*
* call-seq:
* transform_values! {|value| ... } -> self
* transform_values! {|old_value| ... } -> self
* transform_values! -> new_enumerator
*
* Returns +self+, whose keys are unchanged, and whose values are determined by the given block.
*
* With a block given, changes the values of +self+ as determined by the block;
* returns +self+.
*
* For each entry +key+/+old_value+ in +self+,
* calls the block with +old_value+,
* captures its return value as +new_value+,
* and sets <tt>self[key] = new_value</tt>:
*
* h = {foo: 0, bar: 1, baz: 2}
* h.transform_values! {|value| value * 100} # => {foo: 0, bar: 100, baz: 200}
*
* Returns a new Enumerator if no block given:
* h = {foo: 0, bar: 1, baz: 2}
* e = h.transform_values! # => #<Enumerator: {foo: 0, bar: 100, baz: 200}:transform_values!>
* h1 = e.each {|value| value * 100}
* h1 # => {foo: 0, bar: 100, baz: 200}
* With no block given, returns a new Enumerator.
*
* Related: see {Methods for Transforming Keys and Values}[rdoc-ref:Hash@Methods+for+Transforming+Keys+and+Values].
*/
static VALUE
rb_hash_transform_values_bang(VALUE hash)