[Python-checkins] python/nondist/sandbox/csv libcsv.tex,1.10,1.11
montanaro@users.sourceforge.net
montanaro@users.sourceforge.net
Wed, 26 Feb 2003 12:15:47 -0800
Update of /cvsroot/python/python/nondist/sandbox/csv
In directory sc8-pr-cvs1:/tmp/cvs-serv23815
Modified Files:
libcsv.tex
Log Message:
make references to the input or output file-like object uniform
Index: libcsv.tex
===================================================================
RCS file: /cvsroot/python/python/nondist/sandbox/csv/libcsv.tex,v
retrieving revision 1.10
retrieving revision 1.11
diff -C2 -d -r1.10 -r1.11
*** libcsv.tex 26 Feb 2003 19:25:16 -0000 1.10
--- libcsv.tex 26 Feb 2003 20:15:39 -0000 1.11
***************
*** 48,65 ****
The \module{csv} module defines the following functions:
! \begin{funcdesc}{reader}{iterable\optional{,
dialect=\code{'excel'}\optional{, fmtparam}}}
Return a reader object which will iterate over lines in the given
! \var{csvfile}. An optional \var{dialect} parameter can be given
! which is used to define a set of parameters specific to a particular
! CSV dialect. The other optional \var{fmtparam} keyword arguments can
! be given to override individual formatting parameters in the current
dialect. For more information about the dialect and formatting
parameters, see section~\ref{fmt-params}, ``Dialects and Formatting
! Parameters'' for details of these parameters. All data read are
! returned as strings.
\end{funcdesc}
! \begin{funcdesc}{writer}{fileobj\optional{,
dialect=\code{'excel'}\optional{, fmtparam}}}
Return a writer object responsible for converting the user's data into
--- 48,69 ----
The \module{csv} module defines the following functions:
! \begin{funcdesc}{reader}{csvfile\optional{,
dialect=\code{'excel'}\optional{, fmtparam}}}
Return a reader object which will iterate over lines in the given
! {}\var{csvfile}. \var{csvfile} can be any object which supports the
! iterator protocol and returns a string each time its \method{next}
! method is called. An optional \var{dialect} parameter can be given
! which is used to define a set of parameters specific to a particular CSV
! dialect. The other optional {}\var{fmtparam} keyword arguments can be
! given to override individual formatting parameters in the current
dialect. For more information about the dialect and formatting
parameters, see section~\ref{fmt-params}, ``Dialects and Formatting
! Parameters'' for details of these parameters.
!
! All data read are returned as strings. No automatic data type
! conversion is performed.
\end{funcdesc}
! \begin{funcdesc}{writer}{csvfile\optional{,
dialect=\code{'excel'}\optional{, fmtparam}}}
Return a writer object responsible for converting the user's data into
***************
*** 102,108 ****
The \module{csv} module defines the following classes:
! \begin{classdesc}{DictReader}{fileobj, fieldnames\optional{,
! restkey\optional{, restval\optional{,
! dialect=\code{'excel'}\optional{, fmtparam}}}}}
Create an object which operates like a regular reader but maps the
information read into a dict whose keys are given by the \var{fieldnames}
--- 106,114 ----
The \module{csv} module defines the following classes:
! \begin{classdesc}{DictReader}{csvfile, fieldnames\optional{,
! restkey=\code{None}\optional{,
! restval=\code{None}\optional{,
! dialect=\code{'excel'}\optional{,
! fmtparam}}}}}
Create an object which operates like a regular reader but maps the
information read into a dict whose keys are given by the \var{fieldnames}
***************
*** 117,121 ****
! \begin{classdesc}{DictWriter}{fileobj, fieldnames\optional{,
restval=""\optional{,
extrasaction=\code{'raise'}\optional{,
--- 123,127 ----
! \begin{classdesc}{DictWriter}{csvfile, fieldnames\optional{,
restval=""\optional{,
extrasaction=\code{'raise'}\optional{,
***************
*** 124,128 ****
onto output rows. The \var{fieldnames} parameter identifies the order in
which values in the dictionary passed to the \method{writerow()} method are
! written to the \var{fileobj}. The optional \var{restval} parameter
specifies the value to be written if the dictionary is missing a key in
\var{fieldnames}. If the dictionary passed to the \method{writerow()}
--- 130,134 ----
onto output rows. The \var{fieldnames} parameter identifies the order in
which values in the dictionary passed to the \method{writerow()} method are
! written to the \var{csvfile}. The optional \var{restval} parameter
specifies the value to be written if the dictionary is missing a key in
\var{fieldnames}. If the dictionary passed to the \method{writerow()}