Docs: improve sqlite3 placeholders example (GH-101092)
(cherry picked from commit b84be8d9c0e6eca37be14c38250580251a3ef908)
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst
index 2cc0d8a..065243c 100644
--- a/Doc/library/sqlite3.rst
+++ b/Doc/library/sqlite3.rst
@@ -1455,19 +1455,18 @@
con = sqlite3.connect(":memory:")
cur = con.execute("CREATE TABLE lang(name, first_appeared)")
- # This is the qmark style:
- cur.execute("INSERT INTO lang VALUES(?, ?)", ("C", 1972))
+ # This is the named style used with executemany():
+ data = (
+ {"name": "C", "year": 1972},
+ {"name": "Fortran", "year": 1957},
+ {"name": "Python", "year": 1991},
+ {"name": "Go", "year": 2009},
+ )
+ cur.executemany("INSERT INTO lang VALUES(:name, :year)", data)
- # The qmark style used with executemany():
- lang_list = [
- ("Fortran", 1957),
- ("Python", 1991),
- ("Go", 2009),
- ]
- cur.executemany("INSERT INTO lang VALUES(?, ?)", lang_list)
-
- # And this is the named style:
- cur.execute("SELECT * FROM lang WHERE first_appeared = :year", {"year": 1972})
+ # This is the qmark style used in a SELECT query:
+ params = (1972,)
+ cur.execute("SELECT * FROM lang WHERE first_appeared = ?", params)
print(cur.fetchall())
.. testoutput::
