xref: /netbsd-src/external/public-domain/sqlite/man/sqlite3_value_dup.3 (revision d909946ca08dceb44d7d0f22ec9488679695d976)
1.Dd $Mdocdate$
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.Ft sqlite3_value *SQLITE_STDCALL
10.Fo sqlite3_value_dup
11.Fa "const sqlite3_value*"
12.Fc
13.Ft void SQLITE_STDCALL
14.Fo sqlite3_value_free
15.Fa "sqlite3_value*"
16.Fc
17.Sh DESCRIPTION
18The sqlite3_value_dup(V) interface makes a copy of the sqlite3_value
19object D and returns a pointer to that copy.
20The sqlite3_value returned is a protected sqlite3_value
21object even if the input is not.
22The sqlite3_value_dup(V) interface returns NULL if V is NULL or if
23a memory allocation fails.
24.Pp
25The sqlite3_value_free(V) interface frees an sqlite3_value
26object previously obtained from sqlite3_value_dup().
27If V is a NULL pointer then sqlite3_value_free(V) is a harmless no-op.
28.Sh SEE ALSO
29.Xr sqlite3_value 3 ,
30.Xr sqlite3_value_dup 3
31