traceCallBack

The traceCallBack method is an example of a user callback method for the trace method. Here the method name of traceCallBack is used, because it is the default method name if the programmer does not specify his own name in the trace method. Any method name can be used by specifying it as the second argument to the trace method.

Note: there is no traceCallBack method in any ooSQLite class. This method is just used to illustrate how to define a user callback method to be used with when tracing

Arguments:

The arguments sent to the callback method are:

sql [required]	When the statement first begins executing,sqlwill be the SQL statement text. Additional trace callbacks could occur if a triggered subprogram is entered. In these cases,sqlwill be a comment that identifies the trigger.
userData [required]	The user data object specified by the programmer as the third argument to thetracemethod. If the programmer did not specify a user data argument, this will be the .nilobject.

Return value:

The programmer must return a whole number value from the callback, the exact number does not matter.

Details:

The implementation of atracecallback method is is discussed on the SQLite sqlite3_trace page.