Получение имени файла для подключения к базе данных

sqlite3_filename sqlite3_db_filename(sqlite3 *db, const char *zDbName);

Интерфейс sqlite3_db_filename(D,N) возвращает указатель на имя файла, связанный с базой данных N подключения D. Если база данных N не подключена к подключению D, или если база данных N является временной или базой данных в памяти, то эта функция вернёт либо нулевой указатель, либо пустую строку.

Значение строки, возвращаемой этой процедурой, принадлежит и управляется подключением к базе данных. Значение будет валидным до тех пор, пока база данных N не будет отсоединена или пока подключение к базе данных не будет закрыто.

Имя файла, возвращаемое этой функцией, является результатом метода xFullPathname VFS. Другими словами, имя файла будет полным абсолютным путем, даже если имя файла, используемое для открытия базы данных изначально, было URI или относительным путем.

Если указатель на имя файла, возвращённый этой процедурой, не равен NULL, то его можно использовать в качестве входного параметра имени файла для следующих процедур:

• sqlite3_uri_parameter()
• sqlite3_uri_boolean()
• sqlite3_uri_int64()
• sqlite3_filename_database()
• sqlite3_filename_journal()
• sqlite3_filename_wal()

См. также списки объектов, констант и функций.