Project

General

Profile

Bug #10612

Documentation: Document behaviour of Hash#invert

Added by shevegen (Robert A. Heiler) almost 6 years ago. Updated over 5 years ago.

Status:
Closed
Priority:
Normal
Assignee:
-
Target version:
-
ruby -v:
ruby 2.1.5p273 (2014-11-13 revision 48405) [i686-linux]
[ruby-core:66917]

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.

Also available in: Atom PDF