Bug #10612
closedDocumentation: Document behaviour of Hash#invert
Description
Currently a hash loses data if an .invert is done:
{"hey"=>3, "there"=>3, "yippie"=>3, "ack"=>2, "ackack"=>9, "thore"=>3, "yippa"=>9}.invert
Result:
# {3=>"thore", 2=>"ack", 9=>"yippa"}
In the example, this is shown, but it is not documented at:
http://www.ruby-doc.org/core-2.1.5/Hash.html#method-i-invert
As the example already shows it, my suggestion is to extend the documentation
with a sentence such as this:
"If a key with the same name already exists in the Hash then the
last one defined will be used, the earlier key will be discarded."
Or something similar to this.
Updated by shevegen (Robert A. Heiler) almost 10 years ago
For those of you who don't want to click on the link above, here
is the copy paste of the official documentation of said method:
invert → new_hash
Returns a new hash created by using hsh’s values as keys, and the keys as values.
h = { "n" => 100, "m" => 100, "y" => 300, "d" => 200, "a" => 0 }
h.invert #=> {0=>"a", 100=>"m", 200=>"d", 300=>"y"}"
The last two lines are the official example - the last line shows that one key
was lost (key at "n" => 100
))
Updated by nobu (Nobuyoshi Nakada) almost 10 years ago
Robert A. Heiler wrote:
"If a key with the same name already exists in the Hash then the
last one defined will be used, the earlier key will be discarded."
"name" should be "value", I guess.
Updated by ayumin (Ayumu AIZAWA) almost 10 years ago
- Status changed from Open to Closed
- % Done changed from 0 to 100