contrib/sqlite3/sqlite3.h

3190 ** KEYWORDS: {protected sqlite3_value} {unprotected sqlite3_value}
3192 ** SQLite uses the sqlite3_value object to represent all values
3194 ** for the values it stores.  ^Values stored in sqlite3_value objects
3197 ** An sqlite3_value object may be either "protected" or "unprotected".
3198 ** Some interfaces require a protected sqlite3_value.  Other interfaces
3199 ** will accept either a protected or an unprotected sqlite3_value.
3200 ** Every interface that accepts sqlite3_value arguments specifies
3201 ** whether or not it requires a protected sqlite3_value.
3205 ** sqlite3_value object but no mutex is held for an unprotected
3206 ** sqlite3_value object.  If SQLite is compiled to be single-threaded
3211 ** sqlite3_value objects and they can be used interchangeably.  However,
3214 ** sqlite3_value objects even when not strictly required.
3216 ** ^The sqlite3_value objects that are passed as parameters into the
3218 ** ^The sqlite3_value object returned by
3220 ** Unprotected sqlite3_value objects may only be used with
3223 ** interfaces require protected sqlite3_value objects.
3225 typedef struct Mem sqlite3_value;
3343 SQLITE_API int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*);
3739 ** [unprotected sqlite3_value] object.  An unprotected sqlite3_value object
3741 ** If the [unprotected sqlite3_value] object returned by
3844 SQLITE_API sqlite3_value *sqlite3_column_value(sqlite3_stmt*, int iCol);
3993   void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
3994   void (*xStep)(sqlite3_context*,int,sqlite3_value**),
4003   void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
4004   void (*xStep)(sqlite3_context*,int,sqlite3_value**),
4013   void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
4014   void (*xStep)(sqlite3_context*,int,sqlite3_value**),
4063 ** [protected sqlite3_value] objects.  There is one [sqlite3_value] object for
4065 ** extract values from the [sqlite3_value] objects.
4067 ** These routines work only with [protected sqlite3_value] objects.
4068 ** Any attempt to use these routines on an [unprotected sqlite3_value]
4072 ** except that  these routines take a single [protected sqlite3_value] object
4095 ** the SQL function that supplied the [sqlite3_value*] parameters.
4097 SQLITE_API const void *sqlite3_value_blob(sqlite3_value*);
4098 SQLITE_API int sqlite3_value_bytes(sqlite3_value*);
4099 SQLITE_API int sqlite3_value_bytes16(sqlite3_value*);
4100 SQLITE_API double sqlite3_value_double(sqlite3_value*);
4101 SQLITE_API int sqlite3_value_int(sqlite3_value*);
4102 SQLITE_API sqlite3_int64 sqlite3_value_int64(sqlite3_value*);
4103 SQLITE_API const unsigned char *sqlite3_value_text(sqlite3_value*);
4104 SQLITE_API const void *sqlite3_value_text16(sqlite3_value*);
4105 SQLITE_API const void *sqlite3_value_text16le(sqlite3_value*);
4106 SQLITE_API const void *sqlite3_value_text16be(sqlite3_value*);
4107 SQLITE_API int sqlite3_value_type(sqlite3_value*);
4108 SQLITE_API int sqlite3_value_numeric_type(sqlite3_value*);
4341 ** [unprotected sqlite3_value] object specified by the 2nd parameter.  ^The
4342 ** sqlite3_result_value() interface makes a copy of the [sqlite3_value]
4343 ** so that the [sqlite3_value] specified in the parameter may change or
4345 ** ^A [protected sqlite3_value] object may always be used where an
4346 ** [unprotected sqlite3_value] object is required, so either
4347 ** kind of [sqlite3_value] object can be used with this interface.
4367 SQLITE_API void sqlite3_result_value(sqlite3_context*, sqlite3_value*);
5178                 int argc, sqlite3_value **argv);
5183   int (*xUpdate)(sqlite3_vtab *, int, sqlite3_value **, sqlite3_int64 *);
5189                        void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),