diff options
author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2023-01-18 09:43:44 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2023-01-18 09:43:44 (GMT) |
commit | db65a326a4022fbd43648858b460f52734faf1b5 (patch) | |
tree | dc5f06ea738eee254780de0c7287814aa392e883 /Doc | |
parent | 3ef9f6b508a8524f385cdc9fdd4b4afca0eac59b (diff) | |
download | cpython-db65a326a4022fbd43648858b460f52734faf1b5.zip cpython-db65a326a4022fbd43648858b460f52734faf1b5.tar.gz cpython-db65a326a4022fbd43648858b460f52734faf1b5.tar.bz2 |
Docs: improve sqlite3 placeholders example (GH-101092)
(cherry picked from commit b84be8d9c0e6eca37be14c38250580251a3ef908)
Co-authored-by: Erlend E. Aasland <erlend.aasland@protonmail.com>
Diffstat (limited to 'Doc')
-rw-r--r-- | Doc/library/sqlite3.rst | 25 |
1 files changed, 12 insertions, 13 deletions
diff --git a/Doc/library/sqlite3.rst b/Doc/library/sqlite3.rst index c52bdd7..ad5d063 100644 --- a/Doc/library/sqlite3.rst +++ b/Doc/library/sqlite3.rst @@ -1841,19 +1841,18 @@ Here's an example of both styles: 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)) - - # 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 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) + + # 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:: |