diff options
author | Erlend E. Aasland <erlend.aasland@protonmail.com> | 2022-09-04 21:34:45 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-09-04 21:34:45 (GMT) |
commit | 9e5568578234f0ecd003247c8a2deaeb69976b4b (patch) | |
tree | 94ebd21a54d7ab8150086a7e32f684bc9e7423b9 | |
parent | b126196838bbaf5f4d35120e0e6bcde435b0b480 (diff) | |
download | cpython-9e5568578234f0ecd003247c8a2deaeb69976b4b.zip cpython-9e5568578234f0ecd003247c8a2deaeb69976b4b.tar.gz cpython-9e5568578234f0ecd003247c8a2deaeb69976b4b.tar.bz2 |
Docs: alphabetically order sqlite3.Cursor attrs (#96565)
-rw-r--r-- | Doc/library/sqlite3.rst | 61 |
1 files changed, 31 insertions, 30 deletions
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index b188ca4..0dfecc5 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -1468,13 +1468,32 @@ Cursor objects Required by the DB-API. Does nothing in :mod:`!sqlite3`. - .. attribute:: rowcount + .. attribute:: arraysize - Read-only attribute that provides the number of modified rows for - ``INSERT``, ``UPDATE``, ``DELETE``, and ``REPLACE`` statements; - is ``-1`` for other statements, - including :abbr:`CTE (Common Table Expression)` queries. - It is only updated by the :meth:`execute` and :meth:`executemany` methods. + Read/write attribute that controls the number of rows returned by :meth:`fetchmany`. + The default value is 1 which means a single row would be fetched per call. + + .. attribute:: connection + + Read-only attribute that provides the SQLite database :class:`Connection` + belonging to the cursor. A :class:`Cursor` object created by + calling :meth:`con.cursor() <Connection.cursor>` will have a + :attr:`connection` attribute that refers to *con*: + + .. doctest:: + + >>> con = sqlite3.connect(":memory:") + >>> cur = con.cursor() + >>> cur.connection == con + True + + .. attribute:: description + + Read-only attribute that provides the column names of the last query. To + remain compatible with the Python DB API, it returns a 7-tuple for each + column where the last six items of each tuple are ``None``. + + It is set for ``SELECT`` statements without any matching rows as well. .. attribute:: lastrowid @@ -1491,32 +1510,14 @@ Cursor objects .. versionchanged:: 3.6 Added support for the ``REPLACE`` statement. - .. attribute:: arraysize - - Read/write attribute that controls the number of rows returned by :meth:`fetchmany`. - The default value is 1 which means a single row would be fetched per call. - - .. attribute:: description - - Read-only attribute that provides the column names of the last query. To - remain compatible with the Python DB API, it returns a 7-tuple for each - column where the last six items of each tuple are ``None``. - - It is set for ``SELECT`` statements without any matching rows as well. - - .. attribute:: connection - - Read-only attribute that provides the SQLite database :class:`Connection` - belonging to the cursor. A :class:`Cursor` object created by - calling :meth:`con.cursor() <Connection.cursor>` will have a - :attr:`connection` attribute that refers to *con*: + .. attribute:: rowcount - .. doctest:: + Read-only attribute that provides the number of modified rows for + ``INSERT``, ``UPDATE``, ``DELETE``, and ``REPLACE`` statements; + is ``-1`` for other statements, + including :abbr:`CTE (Common Table Expression)` queries. + It is only updated by the :meth:`execute` and :meth:`executemany` methods. - >>> con = sqlite3.connect(":memory:") - >>> cur = con.cursor() - >>> cur.connection == con - True .. The sqlite3.Row example used to be a how-to. It has now been incorporated into the Row reference. We keep the anchor here in order not to break |