mirror of https://github.com/python/cpython
Documentation nits.
This commit is contained in:
parent
f5e8af1bb7
commit
f6b769b464
|
@ -364,8 +364,8 @@ they add the ability to access fields by name instead of position index.
|
||||||
method which lists the tuple contents in a ``name=value`` format.
|
method which lists the tuple contents in a ``name=value`` format.
|
||||||
|
|
||||||
The *fieldnames* are a single string with each fieldname separated by whitespace
|
The *fieldnames* are a single string with each fieldname separated by whitespace
|
||||||
and/or commas (for example 'x y' or 'x, y'). Alternatively, the *fieldnames*
|
and/or commas (for example 'x y' or 'x, y'). Alternatively, *fieldnames*
|
||||||
can be specified with a sequence of strings (such as ['x', 'y']).
|
can be a sequence of strings (such as ['x', 'y']).
|
||||||
|
|
||||||
Any valid Python identifier may be used for a fieldname except for names
|
Any valid Python identifier may be used for a fieldname except for names
|
||||||
starting with an underscore. Valid identifiers consist of letters, digits,
|
starting with an underscore. Valid identifiers consist of letters, digits,
|
||||||
|
@ -482,7 +482,7 @@ three additional methods and one attribute.
|
||||||
|
|
||||||
.. attribute:: somenamedtuple._fields
|
.. attribute:: somenamedtuple._fields
|
||||||
|
|
||||||
Tuple of strings listing the field names. This is useful for introspection
|
Tuple of strings listing the field names. Useful for introspection
|
||||||
and for creating new named tuple types from existing named tuples.
|
and for creating new named tuple types from existing named tuples.
|
||||||
|
|
||||||
::
|
::
|
||||||
|
@ -501,7 +501,7 @@ function::
|
||||||
>>> getattr(p, 'x')
|
>>> getattr(p, 'x')
|
||||||
11
|
11
|
||||||
|
|
||||||
When casting a dictionary to a named tuple, use the double-star-operator [#]_::
|
To cast a dictionary to a named tuple, use the double-star-operator [#]_::
|
||||||
|
|
||||||
>>> d = {'x': 11, 'y': 22}
|
>>> d = {'x': 11, 'y': 22}
|
||||||
>>> Point(**d)
|
>>> Point(**d)
|
||||||
|
@ -526,7 +526,7 @@ a fixed-width print format::
|
||||||
Point: x= 1.286 y= 6.000 hypot= 6.136
|
Point: x= 1.286 y= 6.000 hypot= 6.136
|
||||||
|
|
||||||
Another use for subclassing is to replace performance critcal methods with
|
Another use for subclassing is to replace performance critcal methods with
|
||||||
faster versions that bypass error-checking and localize variable access::
|
faster versions that bypass error-checking and that localize variable access::
|
||||||
|
|
||||||
>>> class Point(namedtuple('Point', 'x y')):
|
>>> class Point(namedtuple('Point', 'x y')):
|
||||||
_make = classmethod(tuple.__new__)
|
_make = classmethod(tuple.__new__)
|
||||||
|
|
Loading…
Reference in New Issue