summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorChristian Heimes <christian@cheimes.de>2007-12-19 02:07:34 (GMT)
committerChristian Heimes <christian@cheimes.de>2007-12-19 02:07:34 (GMT)
commit99170a5dbf4cfee78b578672b6821e855f92594b (patch)
tree06892b1118241d608a9ff6893736d7ea619443bd /Doc
parent2c1816160639f00489aa8bac6178e44bb51e7adb (diff)
downloadcpython-99170a5dbf4cfee78b578672b6821e855f92594b.zip
cpython-99170a5dbf4cfee78b578672b6821e855f92594b.tar.gz
cpython-99170a5dbf4cfee78b578672b6821e855f92594b.tar.bz2
Merged revisions 59541-59561 via svnmerge from
svn+ssh://pythondev@svn.python.org/python/trunk ........ r59544 | raymond.hettinger | 2007-12-18 01:13:45 +0100 (Tue, 18 Dec 2007) | 1 line Add more namedtuple() test cases. Neaten the code and comments. ........ r59545 | christian.heimes | 2007-12-18 04:38:03 +0100 (Tue, 18 Dec 2007) | 3 lines Fixed for #1601: IDLE not working correctly on Windows (Py30a2/IDLE30a1) Amaury's ideas works great. Should we build the Python core with WINVER=0x0500 and _WIN32_WINNT=0x0500, too? ........ r59546 | christian.heimes | 2007-12-18 10:00:13 +0100 (Tue, 18 Dec 2007) | 1 line Make it a bit easier to test Tcl/Tk and idle from a build dir. ........ r59547 | christian.heimes | 2007-12-18 10:12:10 +0100 (Tue, 18 Dec 2007) | 1 line Removed several unused files from the PCbuild9 directory. They are relics from the past. ........ r59548 | raymond.hettinger | 2007-12-18 19:26:18 +0100 (Tue, 18 Dec 2007) | 29 lines Speed-up dictionary constructor by about 10%. New opcode, STORE_MAP saves the compiler from awkward stack manipulations and specializes for dicts using PyDict_SetItem instead of PyObject_SetItem. Old disassembly: 0 BUILD_MAP 0 3 DUP_TOP 4 LOAD_CONST 1 (1) 7 ROT_TWO 8 LOAD_CONST 2 ('x') 11 STORE_SUBSCR 12 DUP_TOP 13 LOAD_CONST 3 (2) 16 ROT_TWO 17 LOAD_CONST 4 ('y') 20 STORE_SUBSCR New disassembly: 0 BUILD_MAP 0 3 LOAD_CONST 1 (1) 6 LOAD_CONST 2 ('x') 9 STORE_MAP 10 LOAD_CONST 3 (2) 13 LOAD_CONST 4 ('y') 16 STORE_MAP ........ r59549 | thomas.heller | 2007-12-18 20:00:34 +0100 (Tue, 18 Dec 2007) | 2 lines Issue #1642: Fix segfault in ctypes when trying to delete attributes. ........ r59551 | guido.van.rossum | 2007-12-18 21:10:42 +0100 (Tue, 18 Dec 2007) | 2 lines Issue #1645 by Alberto Bertogli. Fix a comment. ........ r59553 | raymond.hettinger | 2007-12-18 22:24:09 +0100 (Tue, 18 Dec 2007) | 12 lines Give meaning to the oparg for BUILD_MAP: estimated size of the dictionary. Allows dictionaries to be pre-sized (upto 255 elements) saving time lost to re-sizes with their attendant mallocs and re-insertions. Has zero effect on small dictionaries (5 elements or fewer), a slight benefit for dicts upto 22 elements (because they had to resize once anyway), and more benefit for dicts upto 255 elements (saving multiple resizes during the build-up and reducing the number of collisions on the first insertions). Beyond 255 elements, there is no addional benefit. ........ r59554 | christian.heimes | 2007-12-18 22:56:09 +0100 (Tue, 18 Dec 2007) | 1 line Fixed #1649: IDLE error: dictionary changed size during iteration ........ r59557 | raymond.hettinger | 2007-12-18 23:21:27 +0100 (Tue, 18 Dec 2007) | 1 line Simplify and speedup _asdict() for named tuples. ........ r59558 | christian.heimes | 2007-12-19 00:22:54 +0100 (Wed, 19 Dec 2007) | 3 lines Applied patch #1635: Float patch for inf and nan on Windows (and other platforms). The patch unifies float("inf") and repr(float("inf")) on all platforms. ........ r59559 | raymond.hettinger | 2007-12-19 00:51:15 +0100 (Wed, 19 Dec 2007) | 1 line Users demand iterable input for named tuples. The author capitulates. ........ r59560 | raymond.hettinger | 2007-12-19 01:21:06 +0100 (Wed, 19 Dec 2007) | 1 line Beef-up tests for dict literals ........ r59561 | raymond.hettinger | 2007-12-19 01:27:21 +0100 (Wed, 19 Dec 2007) | 1 line Zap a duplicate line ........
Diffstat (limited to 'Doc')
-rw-r--r--Doc/c-api/utilities.rst16
-rw-r--r--Doc/library/collections.rst49
-rw-r--r--Doc/library/functions.rst10
-rw-r--r--Doc/library/stdtypes.rst9
4 files changed, 58 insertions, 26 deletions
diff --git a/Doc/c-api/utilities.rst b/Doc/c-api/utilities.rst
index e3533f0..18e2733 100644
--- a/Doc/c-api/utilities.rst
+++ b/Doc/c-api/utilities.rst
@@ -1047,6 +1047,22 @@ The following functions provide locale-independent string to number conversions.
See the Unix man page :manpage:`atof(2)` for details.
+
+.. cfunction:: char * PyOS_stricmp(char *s1, char *s2)
+
+ Case insensitive comparsion of strings. The functions works almost
+ identical to :cfunc:`strcmp` except that it ignores the case.
+
+ .. versionadded:: 2.6
+
+
+.. cfunction:: char * PyOS_strnicmp(char *s1, char *s2, Py_ssize_t size)
+
+ Case insensitive comparsion of strings. The functions works almost
+ identical to :cfunc:`strncmp` except that it ignores the case.
+
+ .. versionadded:: 2.6
+
.. _reflection:
diff --git a/Doc/library/collections.rst b/Doc/library/collections.rst
index 1982187..e01c52e 100644
--- a/Doc/library/collections.rst
+++ b/Doc/library/collections.rst
@@ -421,27 +421,31 @@ Example::
__slots__ = ()
- _fields = ('x', 'y')
-
def __new__(cls, x, y):
return tuple.__new__(cls, (x, y))
+ _cast = classmethod(tuple.__new__)
+
def __repr__(self):
return 'Point(x=%r, y=%r)' % self
- def _asdict(self):
+ def _asdict(t):
'Return a new dict which maps field names to their values'
- return dict(zip(('x', 'y'), self))
+ return {'x': t[0], 'y': t[1]}
def _replace(self, **kwds):
'Return a new Point object replacing specified fields with new values'
- return Point(*map(kwds.get, ('x', 'y'), self))
+ return Point._cast(map(kwds.get, ('x', 'y'), self))
+
+ @property
+ def _fields(self):
+ return ('x', 'y')
x = property(itemgetter(0))
y = property(itemgetter(1))
>>> p = Point(11, y=22) # instantiate with positional or keyword arguments
- >>> p[0] + p[1] # indexable like the regular tuple (11, 22)
+ >>> p[0] + p[1] # indexable like the plain tuple (11, 22)
33
>>> x, y = p # unpack like a regular tuple
>>> x, y
@@ -456,33 +460,30 @@ by the :mod:`csv` or :mod:`sqlite3` modules::
EmployeeRecord = namedtuple('EmployeeRecord', 'name, age, title, department, paygrade')
- from itertools import starmap
import csv
- for record in starmap(EmployeeRecord, csv.reader(open("employees.csv", "rb"))):
+ for emp in map(EmployeeRecord._cast, csv.reader(open("employees.csv", "rb"))):
print(emp.name, emp.title)
import sqlite3
conn = sqlite3.connect('/companydata')
cursor = conn.cursor()
cursor.execute('SELECT name, age, title, department, paygrade FROM employees')
- for emp in starmap(EmployeeRecord, cursor.fetchall()):
+ for emp in map(EmployeeRecord._cast, cursor.fetchall()):
print emp.name, emp.title
-When casting a single record to a named tuple, use the star-operator [#]_ to unpack
-the values::
+In addition to the methods inherited from tuples, named tuples support
+three additonal methods and a read-only attribute.
- >>> t = [11, 22]
- >>> Point(*t) # the star-operator unpacks any iterable object
- Point(x=11, y=22)
+.. method:: namedtuple._cast(iterable)
-When casting a dictionary to a named tuple, use the double-star-operator::
+ Class method returning a new instance taking the positional arguments from the *iterable*.
+ Useful for casting existing sequences and iterables to named tuples:
- >>> d = {'x': 11, 'y': 22}
- >>> Point(**d)
- Point(x=11, y=22)
+::
-In addition to the methods inherited from tuples, named tuples support
-two additonal methods and a read-only attribute.
+ >>> t = [11, 22]
+ >>> Point._cast(t)
+ Point(x=11, y=22)
.. method:: somenamedtuple._asdict()
@@ -529,6 +530,12 @@ function:
>>> getattr(p, 'x')
11
+When casting a dictionary to a named tuple, use the double-star-operator [#]_::
+
+ >>> d = {'x': 11, 'y': 22}
+ >>> Point(**d)
+ Point(x=11, y=22)
+
Since a named tuple is a regular Python class, it is easy to add or change
functionality. For example, the display format can be changed by overriding
the :meth:`__repr__` method:
@@ -551,5 +558,5 @@ and customizing it with :meth:`_replace`:
.. rubric:: Footnotes
-.. [#] For information on the star-operator see
+.. [#] For information on the double-star-operator see
:ref:`tut-unpacking-arguments` and :ref:`calls`.
diff --git a/Doc/library/functions.rst b/Doc/library/functions.rst
index 14fd1a7..02c709c2 100644
--- a/Doc/library/functions.rst
+++ b/Doc/library/functions.rst
@@ -435,7 +435,8 @@ available. They are listed here in alphabetical order.
Convert a string or a number to floating point. If the argument is a string, it
must contain a possibly signed decimal or floating point number, possibly
- embedded in whitespace. Otherwise, the argument may be an integer
+ embedded in whitespace. The argument may also be [+|-]nan or [+|-]inf.
+ Otherwise, the argument may be a plain integer
or a floating point number, and a floating point number with the same value
(within Python's floating point precision) is returned. If no argument is
given, returns ``0.0``.
@@ -447,9 +448,10 @@ available. They are listed here in alphabetical order.
single: Infinity
When passing in a string, values for NaN and Infinity may be returned, depending
- on the underlying C library. The specific set of strings accepted which cause
- these values to be returned depends entirely on the C library and is known to
- vary.
+ on the underlying C library. Float accepts the strings nan, inf and -inf for
+ NaN and positive or negative infinity. The case and a leading + are ignored as
+ well as a leading - is ignored for NaN. Float always represents NaN and infinity
+ as nan, inf or -inf.
The float type is described in :ref:`typesnumeric`.
diff --git a/Doc/library/stdtypes.rst b/Doc/library/stdtypes.rst
index 6dd374f..196ad49 100644
--- a/Doc/library/stdtypes.rst
+++ b/Doc/library/stdtypes.rst
@@ -285,7 +285,7 @@ numeric operations have a higher priority than comparison operations):
+---------------------+---------------------------------+-------+--------------------+
| ``int(x)`` | *x* converted to integer | \(3) | :func:`int` |
+---------------------+---------------------------------+-------+--------------------+
-| ``float(x)`` | *x* converted to floating point | | :func:`float` |
+| ``float(x)`` | *x* converted to floating point | \(6) | :func:`float` |
+---------------------+---------------------------------+-------+--------------------+
| ``complex(re, im)`` | a complex number with real part | | :func:`complex` |
| | *re*, imaginary part *im*. | | |
@@ -329,6 +329,13 @@ Notes:
as in C; see functions :func:`floor` and :func:`ceil` in the :mod:`math` module
for well-defined conversions.
+(6)
+ float also accepts the strings "nan" and "inf" with an optional prefix "+"
+ or "-" for Not a Number (NaN) and positive or negative infinity.
+
+ .. versionadded:: 2.6
+
+
.. % XXXJH exceptions: overflow (when? what operations?) zerodivision