diff --git a/ChangeLog b/ChangeLog index dec603b943..7b7340fbb8 100644 --- a/ChangeLog +++ b/ChangeLog @@ -1,3 +1,7 @@ +Sat Feb 13 21:44:58 2016 Tanaka Akira + + * hash.c (rb_hash_invert): [DOC] more examples. + Sat Feb 13 17:30:49 2016 Nobuyoshi Nakada * lib/uri/generic.rb (URI::Generic#find_proxy): support CIDR in diff --git a/hash.c b/hash.c index 7759332a0b..68da110511 100644 --- a/hash.c +++ b/hash.c @@ -2217,6 +2217,22 @@ rb_hash_invert_i(VALUE key, VALUE value, VALUE hash) * h = { "n" => 100, "m" => 100, "y" => 300, "d" => 200, "a" => 0 } * h.invert #=> {0=>"a", 100=>"m", 200=>"d", 300=>"y"} * + * If there is no key with the same value, Hash#invert is involutive. + * + * h = { a: 1, b: 3, c: 4 } + * h.invert.invert == h #=> true + * + * The condition, no key with the same value, can be tested by comparing + * the size of inverted hash. + * + * # no key with the same value + * h = { a: 1, b: 3, c: 4 } + * h.size == h.invert.size #=> true + * + * # two (or more) keys has the same value + * h = { a: 1, b: 3, c: 1 } + * h.size == h.invert.size #=> false + * */ static VALUE