From: ayumu.aizawa@...
Date: 2015-01-03T15:00:50+00:00
Subject: [ruby-core:67311] [ruby-trunk - Bug #10612] [Closed] Documentation: Document behaviour of Hash#invert

Issue #10612 has been updated by Ayumu AIZAWA.

Status changed from Open to Closed
% Done changed from 0 to 100

Applied in changeset r49126.

----------
* hash.c: fix docs for Hash#invert. [ruby-core:66917] [Bug #10612]

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

* Author: Robert A. Heiler
* Status: Closed
* 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/