Updated: 2025/Nov/16

Please read Privacy Policy. It's for your privacy.

SQLITE3_RESULT_SUBTYPE(3)  Library Functions Manual  SQLITE3_RESULT_SUBTYPE(3)

NAME
     sqlite3_result_subtype - setting the subtype of an SQL function

SYNOPSIS
     #include <sqlite3.h>

     void
     sqlite3_result_subtype(sqlite3_context*, unsigned int);

DESCRIPTION
     The sqlite3_result_subtype(C,T) function causes the subtype of the result
     from the application-defined SQL function with sqlite3_context C to be
     the value T.  Only the lower 8 bits of the subtype T are preserved in
     current versions of SQLite; higher order bits are discarded.  The number
     of subtype bytes preserved by SQLite might increase in future releases of
     SQLite.

     Every application-defined SQL function that invokes this interface should
     include the SQLITE_RESULT_SUBTYPE property in its text encoding argument
     when the SQL function is registered.  If the SQLITE_RESULT_SUBTYPE
     property is omitted from the function that invokes
     sqlite3_result_subtype(), then in some cases the sqlite3_result_subtype()
     might fail to set the result subtype.

     If SQLite is compiled with -DSQLITE_STRICT_SUBTYPE=1, then any SQL
     function that invokes the sqlite3_result_subtype() interface and that
     does not have the SQLITE_RESULT_SUBTYPE property will raise an error.
     Future versions of SQLite might enable -DSQLITE_STRICT_SUBTYPE=1 by
     default.

IMPLEMENTATION NOTES
     These declarations were extracted from the interface documentation at
     line 6218.

     SQLITE_API void sqlite3_result_subtype(sqlite3_context*,unsigned int);

SEE ALSO
     sqlite3_context(3), sqlite3_create_function(3), SQLITE_DETERMINISTIC(3)

NetBSD 11.99                   January 24, 2024                   NetBSD 11.99