SQLITE3_VALUE_DUP(3)

SQLITE3_VALUE_DUP(3) | Library Functions Manual | SQLITE3_VALUE_DUP(3)

# NAME

`sqlite3_value_dup`, `sqlite3_value_free` — copy and free SQL values

# SYNOPSIS

`#include <sqlite3.h>`

sqlite3_value *
`sqlite3_value_dup`(const sqlite3_value*);

void
`sqlite3_value_free`(sqlite3_value*);

# DESCRIPTION

The sqlite3_value_dup(V) interface makes a copy of the sqlite3_value object D and returns a pointer to that copy. The sqlite3_value returned is a protected sqlite3_value object even if the input is not. The sqlite3_value_dup(V) interface returns NULL if V is NULL or if a memory allocation fails. If V is a pointer value, then the result of sqlite3_value_dup(V) is a NULL value.

The sqlite3_value_free(V) interface frees an sqlite3_value object previously obtained from `sqlite3_value_dup`(). If V is a NULL pointer then sqlite3_value_free(V) is a harmless no-op.

# IMPLEMENTATION NOTES

These declarations were extracted from the interface documentation at line 5813.

    SQLITE_API sqlite3_value *sqlite3_value_dup(const sqlite3_value*);
    SQLITE_API void sqlite3_value_free(sqlite3_value*);

# SEE ALSO

sqlite3_value(3)

January 24, 2024 | NetBSD 11.0