[Python-checkins] r88222 - python/branches/py3k/Doc/whatsnew/3.2.rst

eric.smith python-checkins at python.org
Fri Jan 28 21:23:25 CET 2011


Author: eric.smith
Date: Fri Jan 28 21:23:25 2011
New Revision: 88222

Log:
Added a placeholder for str.format_map, as discussed with Raymond. My prose is horrible, some cleanup is required.

Modified:
   python/branches/py3k/Doc/whatsnew/3.2.rst

Modified: python/branches/py3k/Doc/whatsnew/3.2.rst
==============================================================================
--- python/branches/py3k/Doc/whatsnew/3.2.rst	(original)
+++ python/branches/py3k/Doc/whatsnew/3.2.rst	Fri Jan 28 21:23:25 2011
@@ -442,6 +442,26 @@
 
   (Suggested by Mark Dickinson and implemented by Eric Smith in :issue:`7094`.)
 
+.. XXX * :meth:`str.format_map` was added, allowing an arbitrary mapping object
+  to be passed in to :meth:`str.format`. `somestring.format_map(mapping)`
+  is similar to `somestring.format(**mapping)`, except that in the latter
+  case `mapping` is convert to a `dict` and in the former case `mapping`
+  is used without modification. For example, to use a `defaultdict` with
+  formatting::
+
+    >>> from collections import defaultdict
+    >>> mapping = defaultdict(lambda: 'Europe', name='Guido')
+    >>> '{name} was born in {country}'.format_map(mapping)
+    'Guido was born in Europe'
+
+  This is similar to %-formatting with a single mapping argument::
+
+    >>> '%(name)s was born in %(country)s' % mapping
+    'Guido was born in Europe'
+
+  (Suggested by Raymond Hettinger and implemented by Eric Smith in
+  :issue:`6081`.)
+
 * The interpreter can now be started with a quiet option, ``-q``, to suppress
   the copyright and version information from being displayed in the interactive
   mode.  The option can be introspected using the :attr:`sys.flags` attribute::


More information about the Python-checkins mailing list