mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-09-26 18:29:57 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 10

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

Browse source 
Patch by Charles-Axel Dein.
This commit is contained in:
Berker Peksag 2014-11-24 23:46:30 +02:00
parent 43052a14c1
commit c8c64e30e8
1 changed files with 25 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

25
Doc/library/csv.rst
View file

@ -158,6 +158,18 @@ The :mod:`csv` module defines the following classes:
the optional *restval* parameter. Any other optional or keyword arguments the optional *restval* parameter. Any other optional or keyword arguments
are passed to the underlying :class:`reader` instance. 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)
@ -180,6 +192,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