/ Check-in [166eb606]
Login

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

Overview
Comment:Updates comments in sqlite.h.in that describe the destructor parameter to sqlite3_bind_.... (CVS 1842)
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 166eb60614d958674469d6661c694aa5955ada7b
User & Date: drh 2004-07-21 15:21:36
Context
2004-07-22
01:19
Initial implementation of variable page sizes and the temp_store pragma. (CVS 1843) check-in: 4cf6e9db user: drh tags: trunk
2004-07-21
15:21
Updates comments in sqlite.h.in that describe the destructor parameter to sqlite3_bind_.... (CVS 1842) check-in: 166eb606 user: drh tags: trunk
14:54
Update the TCL API documentation. (CVS 1841) check-in: df306ad9 user: drh tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to src/sqlite.h.in.

     8      8   **    May you find forgiveness for yourself and forgive others.
     9      9   **    May you share freely, never taking more than you give.
    10     10   **
    11     11   *************************************************************************
    12     12   ** This header file defines the interface that the SQLite library
    13     13   ** presents to client programs.
    14     14   **
    15         -** @(#) $Id: sqlite.h.in,v 1.108 2004/07/15 14:15:02 drh Exp $
           15  +** @(#) $Id: sqlite.h.in,v 1.109 2004/07/21 15:21:36 drh Exp $
    16     16   */
    17     17   #ifndef _SQLITE_H_
    18     18   #define _SQLITE_H_
    19     19   #include <stdarg.h>     /* Needed for the definition of va_list */
    20     20   
    21     21   /*
    22     22   ** Make sure we can call this stuff from C++.
................................................................................
   599    599   ** using the routines listed below.
   600    600   **
   601    601   ** In every case, the first parameter is a pointer to the sqlite3_stmt
   602    602   ** structure returned from sqlite3_prepare().  The second parameter is the
   603    603   ** index of the wildcard.  The first "?" has an index of 1.  ":N:" wildcards
   604    604   ** use the index N.
   605    605   **
   606         -** When the eCopy parameter is true, a copy of the value is made into
   607         -** memory obtained and managed by SQLite.  When eCopy is false, SQLite
   608         -** assumes that the value is a constant and just stores a pointer to the
   609         -** value without making a copy.
          606  +** The fifth parameter to sqlite3_bind_blob(), sqlite3_bind_text(), and
          607  +** sqlite3_bind_text16() is a destructor used to dispose of the BLOB or
          608  +** text after SQLite has finished with it.  If the fifth argument is the
          609  +** special value SQLITE_STATIC, then the library assumes that the information
          610  +** is in static, unmanaged space and does not need to be freed.  If the
          611  +** fifth argument has the value SQLITE_TRANSIENT, then SQLite makes its
          612  +** own private copy of the data.
   610    613   **
   611    614   ** The sqlite3_bind_* routine must be called before sqlite3_step() after
   612    615   ** an sqlite3_prepare() or sqlite3_reset().  Unbound wildcards are interpreted
   613    616   ** as NULL.
   614    617   */
   615    618   int sqlite3_bind_blob(sqlite3_stmt*, int, const void*, int n, void(*)(void*));
   616    619   int sqlite3_bind_double(sqlite3_stmt*, int, double);