--- Doc/lib/libsqlite3.tex.orig 2006-12-18 18:13:10.000000000 +0100 +++ Doc/lib/libsqlite3.tex 2008-01-19 22:44:12.000000000 +0100 @@ -419,6 +419,51 @@ \verbatiminput{sqlite3/executescript.py} \end{methoddesc} +\begin{methoddesc}{fetchone}{} + Fetches the next row of a query result set, returning a + single sequence, or None when no more data is + available. + + An Error (or subclass) exception is raised if the previous + call to executeXXX() did not produce any result set or no + call was issued yet. +\end{methoddesc} + +\begin{methoddesc}{fetchmany}{\optional{size=cursor.arraysize}} + Fetches the next set of rows of a query result, returning a + sequence of sequences (e.g. a list of tuples). An empty + sequence is returned when no more rows are available. + + The number of rows to fetch per call is specified by the + parameter. If it is not given, the cursor's arraysize + determines the number of rows to be fetched. The method + should try to fetch as many rows as indicated by the size + parameter. If this is not possible due to the specified + number of rows not being available, fewer rows may be + returned. + + An Error (or subclass) exception is raised if the previous + call to executeXXX() did not produce any result set or no + call was issued yet. + + Note there are performance considerations involved with + the size parameter. For optimal performance, it is + usually best to use the arraysize attribute. If the size + parameter is used, then it is best for it to retain the + same value from one fetchmany() call to the next. +\end{methoddesc} + +\begin{methoddesc}{fetchall}{} + Fetches all (remaining) rows of a query result, returning + them as a sequence of sequences (e.g. a list of tuples). + Note that the cursor's arraysize attribute can affect the + performance of this operation. + + An Error (or subclass) exception is raised if the previous + call to executeXXX() did not produce any result set or no + call was issued yet. +\end{methoddesc} + \begin{memberdesc}{rowcount} Although the \class{Cursor} class of the \module{sqlite3} module implements this attribute, the database engine's own support for the determination of "rows