traverseda
/
cpython
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Document default fmtspec. Fix inaccurate note. Document exceptions.

This commit is contained in:
Raymond Hettinger 2011-05-11 10:48:02 -07:00
parent bd85f5e7db 30439b23c0
commit caece0a6a0
1 changed files with 7 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
Doc/library/functions.rst
View File

@ -498,11 +498,14 @@ are always available. They are listed here in alphabetical order.
of the *value* argument, however there is a standard formatting syntax that
is used by most built-in types: :ref:`formatspec`.
.. note::
``format(value, format_spec)`` merely calls
``value.__format__(format_spec)``.
The default *format_spec* is an empty string which usually gives the same
effect as calling ``str(value)``.
A call to ``format(value, format_spec)`` is translated to
``type(value).__format__(format_spec)`` which bypasses the instance
dictionary when searching for the value's :meth:`__format__` method. A
:exc:`TypeError` exception is raised if the method is not found or if either
the *format_spec* or the return value are not strings.
.. function:: frozenset([iterable])
:noindex: