.Dd January 24, 2024
.Dt SQLITE3_VALUE_SUBTYPE 3
.Os
.Sh NAME
.Nm sqlite3_value_subtype
.Nd finding the subtype of SQL values
.Sh SYNOPSIS
.In sqlite3.h
.Ft unsigned int
.Fo sqlite3_value_subtype
.Fa "sqlite3_value*"
.Fc
.Sh DESCRIPTION
The sqlite3_value_subtype(V) function returns the subtype for an application-defined SQL function
argument V.
The subtype information can be used to pass a limited amount of context
from one SQL function to another.
Use the
.Fn sqlite3_result_subtype
routine to set the subtype for the return value of an SQL function.
.Pp
Every application-defined SQL function
that invoke this interface should include the SQLITE_SUBTYPE
property in the text encoding argument when the function is registered.
If the SQLITE_SUBTYPE property is omitted, then sqlite3_value_subtype()
might return zero instead of the upstream subtype in some corner cases.
.Sh IMPLEMENTATION NOTES
These declarations were extracted from the
interface documentation at line 5795.
.Bd -literal
SQLITE_API unsigned int sqlite3_value_subtype(sqlite3_value*);
.Ed
.Sh SEE ALSO
.Xr sqlite3_create_function 3 ,
.Xr sqlite3_result_subtype 3 ,
.Xr SQLITE_DETERMINISTIC 3