Updated: 2022/Sep/29

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


SQLITE_DESERIALIZE_FREEONCLOSE(3)                     Library Functions Manual

NAME
     SQLITE_DESERIALIZE_FREEONCLOSE, SQLITE_DESERIALIZE_RESIZEABLE,
     SQLITE_DESERIALIZE_READONLY - flags for sqlite3_deserialize()

SYNOPSIS
     #include <sqlite3.h>

     #define SQLITE_DESERIALIZE_FREEONCLOSE
     #define SQLITE_DESERIALIZE_RESIZEABLE
     #define SQLITE_DESERIALIZE_READONLY

DESCRIPTION
     The following are allowed values for 6th argument (the F argument) to the
     sqlite3_deserialize(D,S,P,N,M,F) interface.

     The SQLITE_DESERIALIZE_FREEONCLOSE means that the database serialization
     in the P argument is held in memory obtained from sqlite3_malloc64() and
     that SQLite should take ownership of this memory and automatically free
     it when it has finished using it.  Without this flag, the caller is
     responsible for freeing any dynamically allocated memory.

     The SQLITE_DESERIALIZE_RESIZEABLE flag means that SQLite is allowed to
     grow the size of the database using calls to sqlite3_realloc64().  This
     flag should only be used if SQLITE_DESERIALIZE_FREEONCLOSE is also used.
     Without this flag, the deserialized database cannot increase in size
     beyond the number of bytes specified by the M parameter.

     The SQLITE_DESERIALIZE_READONLY flag means that the deserialized database
     should be treated as read-only.

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

     #define SQLITE_DESERIALIZE_FREEONCLOSE 1 /* Call sqlite3_free() on close */
     #define SQLITE_DESERIALIZE_RESIZEABLE  2 /* Resize using sqlite3_realloc64() */
     #define SQLITE_DESERIALIZE_READONLY    4 /* Database is read-only */

SEE ALSO
     sqlite3_malloc(3)

NetBSD 10.99                    August 24, 2023                   NetBSD 10.99