Updated: 2025/Nov/16

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

SQLITE3_DB_NAME(3)         Library Functions Manual         SQLITE3_DB_NAME(3)

NAME
     sqlite3_db_name - return the schema name for a database connection

SYNOPSIS
     #include <sqlite3.h>

     const char *
     sqlite3_db_name(sqlite3 *db, int N);

DESCRIPTION
     The sqlite3_db_name(D,N) interface returns a pointer to the schema name
     for the N-th database on database connection D, or a NULL pointer of N is
     out of range.  An N value of 0 means the main database file.  An N of 1
     is the "temp" schema.  Larger values of N correspond to various ATTACH-ed
     databases.

     Space to hold the string that is returned by sqlite3_db_name() is managed
     by SQLite itself.  The string might be deallocated by any operation that
     changes the schema, including ATTACH or DETACH or calls to
     sqlite3_serialize() or sqlite3_deserialize(), even operations that occur
     on a different thread.  Applications that need to remember the string
     long-term should make their own copy.  Applications that are accessing
     the same database connection simultaneously on multiple threads should
     mutex-protect calls to this API and should make their own private copy of
     the result prior to releasing the mutex.

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

     SQLITE_API const char *sqlite3_db_name(sqlite3 *db, int N);

SEE ALSO
     sqlite3_deserialize(3), sqlite3_serialize(3)

NetBSD 11.99                   January 24, 2024                   NetBSD 11.99