xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3_value_dup.3 (revision b9988867a8ad969c45a52aa7628bc932ec98d46b)
1.Dd January 24, 2024
2.Dt SQLITE3_VALUE_DUP 3
3.Os
4.Sh NAME
5.Nm sqlite3_value_dup ,
6.Nm sqlite3_value_free
7.Nd copy and free SQL values
8.Sh SYNOPSIS
9.In sqlite3.h
10.Ft sqlite3_value *
11.Fo sqlite3_value_dup
12.Fa "const sqlite3_value*"
13.Fc
14.Ft void
15.Fo sqlite3_value_free
16.Fa "sqlite3_value*"
17.Fc
18.Sh DESCRIPTION
19The sqlite3_value_dup(V) interface makes a copy of the sqlite3_value
20object D and returns a pointer to that copy.
21The sqlite3_value returned is a protected sqlite3_value
22object even if the input is not.
23The sqlite3_value_dup(V) interface returns NULL if V is NULL or if
24a memory allocation fails.
25If V is a pointer value, then the result of sqlite3_value_dup(V)
26is a NULL value.
27.Pp
28The sqlite3_value_free(V) interface frees an sqlite3_value
29object previously obtained from
30.Fn sqlite3_value_dup .
31If V is a NULL pointer then sqlite3_value_free(V) is a harmless no-op.
32.Sh IMPLEMENTATION NOTES
33These declarations were extracted from the
34interface documentation at line 5813.
35.Bd -literal
36SQLITE_API sqlite3_value *sqlite3_value_dup(const sqlite3_value*);
37SQLITE_API void sqlite3_value_free(sqlite3_value*);
38.Ed
39.Sh SEE ALSO
40.Xr sqlite3_value 3
41