/ Check-in [78f359df]
Login

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

Overview
Comment:Clarify the operation of sqlite3_blob_close() in the API documentation. Ticket #2815. (CVS 4589)
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 78f359dffa6f4af4d5b7e4523f451e0e405350c0
User & Date: drh 2007-12-04 13:22:44
Context
2007-12-04
13:41
Fix a bug in the TCL code for sqlite3_analyzer. (CVS 4590) check-in: 7c2cf454 user: drh tags: trunk
13:22
Clarify the operation of sqlite3_blob_close() in the API documentation. Ticket #2815. (CVS 4589) check-in: 78f359df user: drh tags: trunk
2007-12-03
21:52
Do not require os_other.h if compiling with -DOS_OTHER=1. (CVS 4588) check-in: 96ec3903 user: drh tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to src/sqlite.h.in.

    39     39   ** The requirement number comes first and is enclosed in curly
    40     40   ** braces.  The F prefix identifies functional requirements.
    41     41   ** The requirement consists of all text up through the next
    42     42   ** {...} mark or until the end of the comment.  Text following
    43     43   ** {EX} is an explanatory amplification of the preceding requirement.
    44     44   ** Both the {EX} and the {END} are optional.
    45     45   **
    46         -** @(#) $Id: sqlite.h.in,v 1.273 2007/12/01 19:23:20 drh Exp $
           46  +** @(#) $Id: sqlite.h.in,v 1.274 2007/12/04 13:22:44 drh Exp $
    47     47   */
    48     48   #ifndef _SQLITE3_H_
    49     49   #define _SQLITE3_H_
    50     50   #include <stdarg.h>     /* Needed for the definition of va_list */
    51     51   
    52     52   /*
    53     53   ** Make sure we can call this stuff from C++.
................................................................................
  3305   3305     sqlite3_blob **ppBlob
  3306   3306   );
  3307   3307   
  3308   3308   /*
  3309   3309   ** CAPI3REF:  Close A BLOB Handle
  3310   3310   **
  3311   3311   ** Close an open [sqlite3_blob | blob handle].
         3312  +**
         3313  +** Closing a BLOB might cause the current transaction to commit.
         3314  +** If any writes were made to the BLOB, they might be held in cache
         3315  +** until the close operation.  Closing the BLOB forces the changes
         3316  +** out to disk and so if any I/O errors occur, they will likely occur
         3317  +** at the time when the BLOB is closed.  Any errors that occur during
         3318  +** closing are reported as a non-zero return value.
         3319  +**
         3320  +** The BLOB is closed unconditionally.  Even if this routine returns
         3321  +** an error code, the BLOB is still closed.
  3312   3322   */
  3313   3323   int sqlite3_blob_close(sqlite3_blob *);
  3314   3324   
  3315   3325   /*
  3316   3326   ** CAPI3REF:  Return The Size Of An Open BLOB
  3317   3327   **
  3318   3328   ** Return the size in bytes of the blob accessible via the open