/ Check-in [1c45b2a0]
Login
SQLite training in Houston TX on 2019-11-05 (details)
Part of the 2019 Tcl Conference

Many hyperlinks are disabled.
Use anonymous login to enable hyperlinks.

Overview
Comment:Improvements to the documentation of the sqlite3_db_filename() interface.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 1c45b2a0c055f6fc5da9d00ae2e9171099d904d4
User & Date: drh 2011-11-17 11:49:58
Context
2011-12-12
20:01
Backport a minimal set of changes needed to get 8+3 filenames and the multiplexor shim playing well together. check-in: c4e2ce48 user: drh tags: nx-devkit
2011-11-18
13:10
Change the multiplexor to use a 3-digit suffix. check-in: 0b7edc44 user: drh tags: trunk
2011-11-17
11:49
Improvements to the documentation of the sqlite3_db_filename() interface. check-in: 1c45b2a0 user: drh tags: trunk
11:43
Restore the test for sqlite3OsFullPathname() failure that was mistakenly removed when [ceee03c79a] was backed out by [69ec53fc1c]. check-in: 4d3cf9e1 user: drh tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to src/sqlite.h.in.

  4377   4377   ** CAPI3REF: Return The Filename For A Database Connection
  4378   4378   **
  4379   4379   ** ^The sqlite3_db_filename(D,N) interface returns a pointer to a filename
  4380   4380   ** associated with database N of connection D.  ^The main database file
  4381   4381   ** has the name "main".  If there is no attached database N on the database
  4382   4382   ** connection D, or if database N is a temporary or in-memory database, then
  4383   4383   ** a NULL pointer is returned.
         4384  +**
         4385  +** ^The filename returned by this function is the output of the
         4386  +** xFullPathname method of the [VFS].  ^In other words, the filename
         4387  +** will be an absolute pathname, even if the filename used
         4388  +** to open the database originally was a URI or relative pathname.
  4384   4389   */
  4385   4390   const char *sqlite3_db_filename(sqlite3 *db, const char *zDbName);
  4386   4391   
  4387   4392   /*
  4388   4393   ** CAPI3REF: Find the next prepared statement
  4389   4394   **
  4390   4395   ** ^This interface returns a pointer to the next [prepared statement] after