summaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorErlend E. Aasland <erlend.aasland@protonmail.com>2022-09-04 21:34:45 (GMT)
committerGitHub <noreply@github.com>2022-09-04 21:34:45 (GMT)
commit9e5568578234f0ecd003247c8a2deaeb69976b4b (patch)
tree94ebd21a54d7ab8150086a7e32f684bc9e7423b9
parentb126196838bbaf5f4d35120e0e6bcde435b0b480 (diff)
downloadcpython-9e5568578234f0ecd003247c8a2deaeb69976b4b.zip
cpython-9e5568578234f0ecd003247c8a2deaeb69976b4b.tar.gz
cpython-9e5568578234f0ecd003247c8a2deaeb69976b4b.tar.bz2
Docs: alphabetically order sqlite3.Cursor attrs (#96565)
-rw-r--r--Doc/library/sqlite3.rst61
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