diff options
| -rw-r--r-- | Doc/library/csv.rst | 25 |
1 files changed, 25 insertions, 0 deletions
diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst index ccc9dc6..9f7b58a 100644 --- a/Doc/library/csv.rst +++ b/Doc/library/csv.rst @@ -158,6 +158,18 @@ The :mod:`csv` module defines the following classes: the optional *restval* parameter. Any other optional or keyword 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', \ 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 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 |