summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--Doc/library/stdtypes.rst12
1 files changed, 10 insertions, 2 deletions
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index ebe7b7604c..0ac870be21 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -1042,9 +1042,17 @@ functions based on regular expressions.
Similar to ``str.format(**mapping)``, except that ``mapping`` is
used directly and not copied to a :class:`dict` . This is useful
- if for example ``mapping`` is a dict subclass.
+ if for example ``mapping`` is a dict subclass:
+
+ >>> class Default(dict):
+ ... def __missing__(self, key):
+ ... return key
+ ...
+ >>> '{name} was born in {country}'.format_map(Default(name='Guido'))
+ 'Guido was born in country'
+
+ .. versionadded:: 3.2
- .. versionadded:: 3.2
.. method:: str.index(sub[, start[, end]])