bidict/docs/beware-on_dup_kv-overwrite....

16 lines
513 B
PHP
Raw Normal View History

2016-06-28 04:05:22 +00:00
Beware ``on_dup_kv=OVERWRITE``
++++++++++++++++++++++++++++++
Beware that ``on_dup_kv=OVERWRITE`` semantics
(which :class:`loosebidict <bidict.loosebidict>` uses by default)
cause the following potentially surprising behavior::
>>> from bidict import loosebidict
>>> b = loosebidict({'one': 1, 'two': 2})
>>> b['one'] = 2
>>> b
loosebidict({'one': 2})
That is, setting an existing key to the value of a different existing item
causes both existing items to be collapsed into a single item.