@@ -487,7 +487,7 @@ Connection Objects
487
487
488
488
.. method :: set_authorizer(authorizer_callback)
489
489
490
- This routine registers a callback. The callback is invoked for each attempt to
490
+ Register callable * authorizer_callback * to be invoked for each attempt to
491
491
access a column of a table in the database. The callback should return
492
492
:const: `SQLITE_OK ` if access is allowed, :const: `SQLITE_DENY ` if the entire SQL
493
493
statement should be aborted with an error and :const: `SQLITE_IGNORE ` if the
@@ -508,7 +508,7 @@ Connection Objects
508
508
509
509
.. method :: set_progress_handler(progress_handler, n)
510
510
511
- This routine registers a callback. The callback is invoked for every *n *
511
+ Register callable * progress_handler * to be invoked for every *n *
512
512
instructions of the SQLite virtual machine. This is useful if you want to
513
513
get called from SQLite during long-running operations, for example to update
514
514
a GUI.
@@ -523,8 +523,8 @@ Connection Objects
523
523
524
524
.. method :: set_trace_callback(trace_callback)
525
525
526
- Registers *trace_callback * to be called for each SQL statement that is
527
- actually executed by the SQLite backend.
526
+ Register callable *trace_callback * to be invoked for each SQL statement
527
+ that is actually executed by the SQLite backend.
528
528
529
529
The only argument passed to the callback is the statement (as
530
530
:class: `str `) that is being executed. The return value of the callback is
@@ -547,8 +547,10 @@ Connection Objects
547
547
548
548
.. method :: enable_load_extension(enabled, /)
549
549
550
- This routine allows/disallows the SQLite engine to load SQLite extensions
551
- from shared libraries. SQLite extensions can define new functions,
550
+ Enable the SQLite engine to load SQLite extensions from shared libraries
551
+ if *enabled * is :const: `True `;
552
+ else, disallow loading SQLite extensions.
553
+ SQLite extensions can define new functions,
552
554
aggregates or whole new virtual table implementations. One well-known
553
555
extension is the fulltext-search extension distributed with SQLite.
554
556
@@ -565,9 +567,9 @@ Connection Objects
565
567
566
568
.. method :: load_extension(path, /)
567
569
568
- This routine loads an SQLite extension from a shared library. You have to
569
- enable extension loading with :meth: `enable_load_extension ` before you can
570
- use this routine .
570
+ Load an SQLite extension from a shared library located at * path *.
571
+ Enable extension loading with :meth: `enable_load_extension ` before
572
+ calling this method .
571
573
572
574
Loadable extensions are disabled by default. See [#f1 ]_.
573
575
@@ -704,8 +706,10 @@ Cursor Objects
704
706
705
707
.. method :: execute(sql, parameters=(), /)
706
708
707
- Execute an SQL statement. Values may be bound to the statement using
708
- :ref: `placeholders <sqlite3-placeholders >`.
709
+ Execute SQL statement *sql *.
710
+ Bind values to the statement using :ref: `placeholders
711
+ <sqlite3-placeholders>` that map to the :term: `sequence ` or :class: `dict `
712
+ *parameters *.
709
713
710
714
:meth: `execute ` will only execute a single SQL statement. If you try to execute
711
715
more than one statement with it, it will raise a :exc: `Warning `. Use
@@ -720,7 +724,7 @@ Cursor Objects
720
724
721
725
.. method :: executemany(sql, seq_of_parameters, /)
722
726
723
- Execute a :ref: `parameterized <sqlite3-placeholders >` SQL command
727
+ Execute :ref: `parameterized <sqlite3-placeholders >` SQL statement * sql *
724
728
against all parameter sequences or mappings found in the sequence
725
729
*seq_of_parameters *. It is also possible to use an
726
730
:term: `iterator ` yielding parameters instead of a sequence.
@@ -735,7 +739,7 @@ Cursor Objects
735
739
736
740
.. method :: executescript(sql_script, /)
737
741
738
- Execute multiple SQL statements at once .
742
+ Execute the SQL statements in * sql_script * .
739
743
If there is a pending transaciton,
740
744
an implicit ``COMMIT `` statement is executed first.
741
745
No other implicit transaction control is performed;
0 commit comments