|
void *sqlite3_aggregate_context(sqlite3_context*, int nBytes);
The implementation of aggregate SQL functions use this routine to allocate a structure for storing their state.
The first time the sqlite3_aggregate_context() routine is called for a particular aggregate, SQLite allocates nBytes of memory, zeroes out that memory, and returns a pointer to it. On second and subsequent calls to sqlite3_aggregate_context() for the same aggregate function index, the same buffer is returned. The implementation of the aggregate can use the returned buffer to accumulate data.
SQLite automatically frees the allocated buffer when the aggregate query concludes.
The first parameter should be a copy of the SQL function context that is the first parameter to the callback routine that implements the aggregate function.
This routine must be called from the same thread in which the aggregate SQL function is running.
Requirements: H16211 H16213 H16215 H16217
See also lists of Objects, Constants, and Functions.