lib/sqlite/sqlite3.h

2929 ** KEYWORDS: {protected sqlite3_value} {unprotected sqlite3_value}
2931 ** SQLite uses the sqlite3_value object to represent all values
2933 ** for the values it stores.  ^Values stored in sqlite3_value objects
2936 ** An sqlite3_value object may be either "protected" or "unprotected".
2937 ** Some interfaces require a protected sqlite3_value.  Other interfaces
2938 ** will accept either a protected or an unprotected sqlite3_value.
2939 ** Every interface that accepts sqlite3_value arguments specifies
2940 ** whether or not it requires a protected sqlite3_value.
2944 ** sqlite3_value object but no mutex is held for an unprotected
2945 ** sqlite3_value object.  If SQLite is compiled to be single-threaded
2950 ** sqlite3_value objects and they can be used interchangeably.  However,
2953 ** sqlite3_value objects even when not strictly required.
2955 ** ^The sqlite3_value objects that are passed as parameters into the
2957 ** ^The sqlite3_value object returned by
2959 ** Unprotected sqlite3_value objects may only be used with
2962 ** interfaces require protected sqlite3_value objects.
2964 typedef struct Mem sqlite3_value;
3069 SQLITE_API int sqlite3_bind_value(sqlite3_stmt*, int, const sqlite3_value*);
3459 ** [unprotected sqlite3_value] object.  An unprotected sqlite3_value object
3461 ** If the [unprotected sqlite3_value] object returned by
3564 SQLITE_API sqlite3_value *sqlite3_column_value(sqlite3_stmt*, int iCol);
3713   void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
3714   void (*xStep)(sqlite3_context*,int,sqlite3_value**),
3723   void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
3724   void (*xStep)(sqlite3_context*,int,sqlite3_value**),
3733   void (*xFunc)(sqlite3_context*,int,sqlite3_value**),
3734   void (*xStep)(sqlite3_context*,int,sqlite3_value**),
3782 ** [protected sqlite3_value] objects.  There is one [sqlite3_value] object for
3784 ** extract values from the [sqlite3_value] objects.
3786 ** These routines work only with [protected sqlite3_value] objects.
3787 ** Any attempt to use these routines on an [unprotected sqlite3_value]
3791 ** except that  these routines take a single [protected sqlite3_value] object
3814 ** the SQL function that supplied the [sqlite3_value*] parameters.
3816 SQLITE_API const void *sqlite3_value_blob(sqlite3_value*);
3817 SQLITE_API int sqlite3_value_bytes(sqlite3_value*);
3818 SQLITE_API int sqlite3_value_bytes16(sqlite3_value*);
3819 SQLITE_API double sqlite3_value_double(sqlite3_value*);
3820 SQLITE_API int sqlite3_value_int(sqlite3_value*);
3821 SQLITE_API sqlite3_int64 sqlite3_value_int64(sqlite3_value*);
3822 SQLITE_API const unsigned char *sqlite3_value_text(sqlite3_value*);
3823 SQLITE_API const void *sqlite3_value_text16(sqlite3_value*);
3824 SQLITE_API const void *sqlite3_value_text16le(sqlite3_value*);
3825 SQLITE_API const void *sqlite3_value_text16be(sqlite3_value*);
3826 SQLITE_API int sqlite3_value_type(sqlite3_value*);
3827 SQLITE_API int sqlite3_value_numeric_type(sqlite3_value*);
4052 ** [unprotected sqlite3_value] object specified by the 2nd parameter.  ^The
4053 ** sqlite3_result_value() interface makes a copy of the [sqlite3_value]
4054 ** so that the [sqlite3_value] specified in the parameter may change or
4056 ** ^A [protected sqlite3_value] object may always be used where an
4057 ** [unprotected sqlite3_value] object is required, so either
4058 ** kind of [sqlite3_value] object can be used with this interface.
4078 SQLITE_API void sqlite3_result_value(sqlite3_context*, sqlite3_value*);
4783                 int argc, sqlite3_value **argv);
4788   int (*xUpdate)(sqlite3_vtab *, int, sqlite3_value **, sqlite3_int64 *);
4794                        void (**pxFunc)(sqlite3_context*,int,sqlite3_value**),