summaryrefslogtreecommitdiff
path: root/Doc
diff options
context:
space:
mode:
authorBerker Peksag <berker.peksag@gmail.com>2017-01-07 09:32:56 +0300
committerBerker Peksag <berker.peksag@gmail.com>2017-01-07 09:32:56 +0300
commit11d700400c19bedf3d5d6c543a259f2bf35e3979 (patch)
tree4345c5b77ebd1114fca34f57d547d3b1bcc3ab58 /Doc
parentf9d2ba6b16dab9d8057cd682ae8d7d044a750756 (diff)
downloadcpython-11d700400c19bedf3d5d6c543a259f2bf35e3979.tar.gz
Issue #16026: Fix parameter names of DictReader and DictWriter
CPython and PyPy use f as the name of the first parameter of DictReader and DictWriter classes. Patch by James Salt and Greg Bengeult.
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/csv.rst12
1 files changed, 6 insertions, 6 deletions
diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst
index f916572fd5..52a8a310ec 100644
--- a/Doc/library/csv.rst
+++ b/Doc/library/csv.rst
@@ -146,7 +146,7 @@ The :mod:`csv` module defines the following functions:
The :mod:`csv` module defines the following classes:
-.. class:: DictReader(csvfile, fieldnames=None, restkey=None, restval=None, \
+.. class:: DictReader(f, fieldnames=None, restkey=None, restval=None, \
dialect='excel', *args, **kwds)
Create an object that operates like a regular reader but maps the
@@ -154,7 +154,7 @@ The :mod:`csv` module defines the following classes:
whose keys are given by the optional *fieldnames* parameter.
The *fieldnames* parameter is a :term:`sequence`. If *fieldnames* is
- omitted, the values in the first row of the *csvfile* will be used as the
+ omitted, the values in the first row of file *f* will be used as the
fieldnames. Regardless of how the fieldnames are determined, the ordered
dictionary preserves their original ordering.
@@ -184,14 +184,14 @@ The :mod:`csv` module defines the following classes:
OrderedDict([('first_name', 'John'), ('last_name', 'Cleese')])
-.. class:: DictWriter(csvfile, fieldnames, restval='', extrasaction='raise', \
+.. class:: DictWriter(f, fieldnames, restval='', extrasaction='raise', \
dialect='excel', *args, **kwds)
Create an object which operates like a regular writer but maps dictionaries
onto output rows. The *fieldnames* parameter is a :mod:`sequence
<collections.abc>` of keys that identify the order in which values in the
- dictionary passed to the :meth:`writerow` method are written to the
- *csvfile*. The optional *restval* parameter specifies the value to be
+ dictionary passed to the :meth:`writerow` method are written to file
+ *f*. The optional *restval* parameter specifies the value to be
written if the dictionary is missing a key in *fieldnames*. If the
dictionary passed to the :meth:`writerow` method contains a key not found in
*fieldnames*, the optional *extrasaction* parameter indicates what action to
@@ -205,7 +205,7 @@ The :mod:`csv` module defines the following classes:
Note that unlike the :class:`DictReader` class, the *fieldnames* parameter
of the :class:`DictWriter` is not optional. Since Python's :class:`dict`
objects are not ordered, there is not enough information available to deduce
- the order in which the row should be written to the *csvfile*.
+ the order in which the row should be written to file *f*.
A short usage example::