diff options
author | Erlend Egeberg Aasland <erlend.aasland@innova.no> | 2022-01-08 19:17:09 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2022-01-08 19:17:09 (GMT) |
commit | b6aa38f1ca79600f2ab46ac114ff36461a19c4a3 (patch) | |
tree | 1bd71ae6e8dad6671b1aa951d11a6eb7b3d8f333 /Doc | |
parent | ef5376e69e72fa922d7f1b3df47b99d3576f9df1 (diff) | |
download | cpython-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.rst | 17 |
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. |