summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorErlend Egeberg Aasland <erlend.aasland@innova.no>2022-01-08 19:17:09 (GMT)
committerGitHub <noreply@github.com>2022-01-08 19:17:09 (GMT)
commitb6aa38f1ca79600f2ab46ac114ff36461a19c4a3 (patch)
tree1bd71ae6e8dad6671b1aa951d11a6eb7b3d8f333 /Doc
parentef5376e69e72fa922d7f1b3df47b99d3576f9df1 (diff)
downloadcpython-b6aa38f1ca79600f2ab46ac114ff36461a19c4a3.zip
cpython-b6aa38f1ca79600f2ab46ac114ff36461a19c4a3.tar.gz
cpython-b6aa38f1ca79600f2ab46ac114ff36461a19c4a3.tar.bz2
bpo-46261: Update `sqlite3.Cursor.lastrowid` docs (GH-30407)
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/sqlite3.rst17
1 files changed, 9 insertions, 8 deletions
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index fb38182..415a5f9 100644
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -845,14 +845,15 @@ Cursor Objects
.. attribute:: lastrowid
- This read-only attribute provides the rowid of the last modified row. It is
- only set if you issued an ``INSERT`` or a ``REPLACE`` statement using the
- :meth:`execute` method. For operations other than ``INSERT`` or
- ``REPLACE`` or when :meth:`executemany` is called, :attr:`lastrowid` is
- set to :const:`None`.
-
- If the ``INSERT`` or ``REPLACE`` statement failed to insert the previous
- successful rowid is returned.
+ This read-only attribute provides the row id of the last inserted row. It
+ is only updated after successful ``INSERT`` or ``REPLACE`` statements
+ using the :meth:`execute` method. For other statements, after
+ :meth:`executemany` or :meth:`executescript`, or if the insertion failed,
+ the value of ``lastrowid`` is left unchanged. The initial value of
+ ``lastrowid`` is :const:`None`.
+
+ .. note::
+ Inserts into ``WITHOUT ROWID`` tables are not recorded.
.. versionchanged:: 3.6
Added support for the ``REPLACE`` statement.