Skip to content

Commit 0c81909

Browse files
Docs: alphabetically order sqlite3.Cursor attrs (GH-96565)
(cherry picked from commit 9e55685) Co-authored-by: Erlend E. Aasland <[email protected]>
1 parent 8a776d1 commit 0c81909

File tree

1 file changed

+31
-30
lines changed

1 file changed

+31
-30
lines changed

Doc/library/sqlite3.rst

+31-30
Original file line numberDiff line numberDiff line change
@@ -1455,13 +1455,32 @@ Cursor objects
14551455

14561456
Required by the DB-API. Does nothing in :mod:`!sqlite3`.
14571457

1458-
.. attribute:: rowcount
1458+
.. attribute:: arraysize
14591459

1460-
Read-only attribute that provides the number of modified rows for
1461-
``INSERT``, ``UPDATE``, ``DELETE``, and ``REPLACE`` statements;
1462-
is ``-1`` for other statements,
1463-
including :abbr:`CTE (Common Table Expression)` queries.
1464-
It is only updated by the :meth:`execute` and :meth:`executemany` methods.
1460+
Read/write attribute that controls the number of rows returned by :meth:`fetchmany`.
1461+
The default value is 1 which means a single row would be fetched per call.
1462+
1463+
.. attribute:: connection
1464+
1465+
Read-only attribute that provides the SQLite database :class:`Connection`
1466+
belonging to the cursor. A :class:`Cursor` object created by
1467+
calling :meth:`con.cursor() <Connection.cursor>` will have a
1468+
:attr:`connection` attribute that refers to *con*:
1469+
1470+
.. doctest::
1471+
1472+
>>> con = sqlite3.connect(":memory:")
1473+
>>> cur = con.cursor()
1474+
>>> cur.connection == con
1475+
True
1476+
1477+
.. attribute:: description
1478+
1479+
Read-only attribute that provides the column names of the last query. To
1480+
remain compatible with the Python DB API, it returns a 7-tuple for each
1481+
column where the last six items of each tuple are ``None``.
1482+
1483+
It is set for ``SELECT`` statements without any matching rows as well.
14651484

14661485
.. attribute:: lastrowid
14671486

@@ -1478,32 +1497,14 @@ Cursor objects
14781497
.. versionchanged:: 3.6
14791498
Added support for the ``REPLACE`` statement.
14801499

1481-
.. attribute:: arraysize
1482-
1483-
Read/write attribute that controls the number of rows returned by :meth:`fetchmany`.
1484-
The default value is 1 which means a single row would be fetched per call.
1485-
1486-
.. attribute:: description
1487-
1488-
Read-only attribute that provides the column names of the last query. To
1489-
remain compatible with the Python DB API, it returns a 7-tuple for each
1490-
column where the last six items of each tuple are ``None``.
1491-
1492-
It is set for ``SELECT`` statements without any matching rows as well.
1493-
1494-
.. attribute:: connection
1495-
1496-
Read-only attribute that provides the SQLite database :class:`Connection`
1497-
belonging to the cursor. A :class:`Cursor` object created by
1498-
calling :meth:`con.cursor() <Connection.cursor>` will have a
1499-
:attr:`connection` attribute that refers to *con*:
1500+
.. attribute:: rowcount
15001501

1501-
.. doctest::
1502+
Read-only attribute that provides the number of modified rows for
1503+
``INSERT``, ``UPDATE``, ``DELETE``, and ``REPLACE`` statements;
1504+
is ``-1`` for other statements,
1505+
including :abbr:`CTE (Common Table Expression)` queries.
1506+
It is only updated by the :meth:`execute` and :meth:`executemany` methods.
15021507

1503-
>>> con = sqlite3.connect(":memory:")
1504-
>>> cur = con.cursor()
1505-
>>> cur.connection == con
1506-
True
15071508

15081509
.. The sqlite3.Row example used to be a how-to. It has now been incorporated
15091510
into the Row reference. We keep the anchor here in order not to break

0 commit comments

Comments
 (0)