From: Ned Batchelder Date: Fri, 3 May 2024 15:48:27 +0000 (-0400) Subject: docs: clarify csv.DictReader's treatment of the first data row (#118549) X-Git-Tag: v3.13.0b1~134 X-Git-Url: http://git.ipfire.org/gitweb.cgi?a=commitdiff_plain;h=9d67b72a4952766fdba803eb6eadd41dfee29dff;p=thirdparty%2FPython%2Fcpython.git docs: clarify csv.DictReader's treatment of the first data row (#118549) --- diff --git a/Doc/library/csv.rst b/Doc/library/csv.rst index 4ee7820585d3..d17468023c6d 100644 --- a/Doc/library/csv.rst +++ b/Doc/library/csv.rst @@ -156,8 +156,10 @@ The :mod:`csv` module defines the following classes: The *fieldnames* parameter is a :term:`sequence`. If *fieldnames* is omitted, the values in the first row of file *f* will be used as the - fieldnames. Regardless of how the fieldnames are determined, the - dictionary preserves their original ordering. + fieldnames and will be omitted from the results. If + *fieldnames* is provided, they will be used and the first row will be + included in the results. Regardless of how the fieldnames are determined, + the dictionary preserves their original ordering. If a row has more fields than fieldnames, the remaining data is put in a list and stored with the fieldname specified by *restkey* (which defaults