[ruby-core:66917] [ruby-trunk - Bug #10612] [Open] Documentation: Document behaviour of Hash#invert

From: shevegen@...
Date: 2014-12-17 17:49:26 UTC
List: ruby-core #66917
Issue #10612 has been reported by Robert A. Heiler.

----------------------------------------
Bug #10612: Documentation: Document behaviour of Hash#invert
https://bugs.ruby-lang.org/issues/10612

* Author: Robert A. Heiler
* Status: Open
* Priority: Low
* Assignee: 
* Category: 
* Target version: 
* ruby -v: ruby 2.1.5p273 (2014-11-13 revision 48405) [i686-linux]
* Backport: 2.0.0: UNKNOWN, 2.1: UNKNOWN
----------------------------------------
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.



-- 
https://bugs.ruby-lang.org/

In This Thread

Prev Next