Issue 10533: Need example of using __missing__.

This commit is contained in:
Raymond Hettinger 2011-01-08 09:35:38 +00:00
parent 0ab10e4600
commit 5254e9700e
1 changed files with 14 additions and 2 deletions

View File

@ -2117,8 +2117,20 @@ pairs within braces, for example: ``{'jack': 4098, 'sjoerd': 4127}`` or ``{4098:
returned or raised by the ``__missing__(key)`` call if the key is not
present. No other operations or methods invoke :meth:`__missing__`. If
:meth:`__missing__` is not defined, :exc:`KeyError` is raised.
:meth:`__missing__` must be a method; it cannot be an instance variable. For
an example, see :class:`collections.defaultdict`.
:meth:`__missing__` must be a method; it cannot be an instance variable::
>>> class Counter(dict):
... def __missing__(self, key):
... return 0
>>> c = Counter()
>>> c['red']
0
>>> c['red'] += 1
>>> c['red']
1
See :class:`collections.Counter` for a complete implementation including
other methods helpful for accumulating and managing tallies.
.. describe:: d[key] = value