From 63847496f14c813a5d80efd5b7de0f1294ffe1e3 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 13 Apr 2024 16:07:11 +0200 Subject: Adding upstream version 3.45.1. Signed-off-by: Daniel Baumann --- www/c3ref/trace_v2.html | 162 ++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 162 insertions(+) create mode 100644 www/c3ref/trace_v2.html (limited to 'www/c3ref/trace_v2.html') diff --git a/www/c3ref/trace_v2.html b/www/c3ref/trace_v2.html new file mode 100644 index 0000000..a9bd9dc --- /dev/null +++ b/www/c3ref/trace_v2.html @@ -0,0 +1,162 @@ + + + + + +SQL Trace Hook + + + +
+ + + +
+
+Small. Fast. Reliable.
Choose any three. +
+
+ +
+ +
+
+ + + +
+
+
+ + +
+

SQLite C Interface

 +

SQL Trace Hook

+
+
+int sqlite3_trace_v2(
+  sqlite3*,
+  unsigned uMask,
+  int(*xCallback)(unsigned,void*,void*,void*),
+  void *pCtx
+);
+
+

+The sqlite3_trace_v2(D,M,X,P) interface registers a trace callback +function X against database connection D, using property mask M +and context pointer P. If the X callback is +NULL or if the M mask is zero, then tracing is disabled. The +M argument should be the bitwise OR-ed combination of +zero or more SQLITE_TRACE constants.

+ +

Each call to either sqlite3_trace(D,X,P) or sqlite3_trace_v2(D,M,X,P) +overrides (cancels) all prior calls to sqlite3_trace(D,X,P) or +sqlite3_trace_v2(D,M,X,P) for the database connection D. Each +database connection may have at most one trace callback.

+ +

The X callback is invoked whenever any of the events identified by +mask M occur. The integer return value from the callback is currently +ignored, though this may change in future releases. Callback +implementations should return zero to ensure future compatibility.

+ +

A trace callback is invoked with four arguments: callback(T,C,P,X). +The T argument is one of the SQLITE_TRACE +constants to indicate why the callback was invoked. +The C argument is a copy of the context pointer. +The P and X arguments are pointers whose meanings depend on T.

+ +

The sqlite3_trace_v2() interface is intended to replace the legacy +interfaces sqlite3_trace() and sqlite3_profile(), both of which +are deprecated. +

See also lists of + Objects, + Constants, and + Functions.

+ -- cgit v1.2.3