Commit 8a9c682d authored by Berker Peksag's avatar Berker Peksag

Issue #20351: Add examples for csv.DictReader and csv.DictWriter.

Patch by Charles-Axel Dein.
parent 40ce014b
...@@ -180,6 +180,18 @@ The :mod:`csv` module defines the following classes: ...@@ -180,6 +180,18 @@ The :mod:`csv` module defines the following classes:
of the optional *restval* parameter. Any other optional or keyword of the optional *restval* parameter. Any other optional or keyword
arguments are passed to the underlying :class:`reader` instance. arguments are passed to the underlying :class:`reader` instance.
A short usage example::
>>> import csv
>>> with open('names.csv') as csvfile:
... reader = csv.DictReader(csvfile)
... for row in reader:
... print(row['first_name'], row['last_name'])
...
Baked Beans
Lovely Spam
Wonderful Spam
.. class:: DictWriter(csvfile, fieldnames, restval='', extrasaction='raise', \ .. class:: DictWriter(csvfile, fieldnames, restval='', extrasaction='raise', \
dialect='excel', *args, **kwds) dialect='excel', *args, **kwds)
...@@ -202,6 +214,19 @@ The :mod:`csv` module defines the following classes: ...@@ -202,6 +214,19 @@ The :mod:`csv` module defines the following classes:
objects are not ordered, there is not enough information available to deduce 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 the *csvfile*.
A short usage example::
import csv
with open('names.csv', 'w') as csvfile:
fieldnames = ['first_name', 'last_name']
writer = csv.DictWriter(csvfile, fieldnames=fieldnames)
writer.writeheader()
writer.writerow({'first_name': 'Baked', 'last_name': 'Beans'})
writer.writerow({'first_name': 'Lovely', 'last_name': 'Spam'})
writer.writerow({'first_name': 'Wonderful', 'last_name': 'Spam'})
.. class:: Dialect .. class:: Dialect
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment