diff -r 9a98ff4a2290 Doc/library/csv.rst --- a/Doc/library/csv.rst Wed Jan 22 05:49:11 2014 -0800 +++ b/Doc/library/csv.rst Wed Jan 22 10:05:24 2014 -0800 @@ -154,6 +154,17 @@ *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'].upper()) + Baked BEANS + Lovely SPAM + Wonderful SPAM + .. class:: DictWriter(csvfile, fieldnames, restval='', extrasaction='raise', dialect='excel', *args, **kwds) @@ -173,6 +184,19 @@ 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