Mirror
/
cpython
mirror of https://github.com/python/cpython
4
1
Fork 0
Code Issues Releases Wiki Activity

bpo-46261: Update `sqlite3.Cursor.lastrowid` docs (GH-30407)

This commit is contained in:
Erlend Egeberg Aasland 2022-01-08 20:17:09 +01:00 committed by GitHub
parent ef5376e69e
commit b6aa38f1ca
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 8 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

15
Doc/library/sqlite3.rst
View File

@ -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`.
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`.
If the ``INSERT`` or ``REPLACE`` statement failed to insert the previous
successful rowid is returned.
.. note::
Inserts into ``WITHOUT ROWID`` tables are not recorded.
.. versionchanged:: 3.6
Added support for the ``REPLACE`` statement.