/ Check-in [01b4cb26]
Login

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

Overview
Comment:Clarify the documentation on sqlite3_column_count().
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | branch-3.16
Files: files | file ages | folders
SHA1:01b4cb26762f42064311445f65304388d6fdcfb5
User & Date: dan 2017-01-06 13:53:37
Context
2017-01-06
16:32
Version 3.16.2 Leaf check-in: a65a6289 user: drh tags: release, branch-3.16, version-3.16.2
13:53
Clarify the documentation on sqlite3_column_count(). check-in: 01b4cb26 user: dan tags: branch-3.16
13:52
Ensure that "PRAGMA case_sensitive_like" and "PRAGMA shrink_memory" set the number of output columns to 0 (as they are statements that return no data). check-in: 4a97ba4e user: dan tags: branch-3.16
01:09
Clarify the documentation on sqlite3_column_count(). check-in: 9ea0badd user: drh tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Show Whitespace Changes Patch

Changes to src/sqlite.h.in.

  3892   3892   int sqlite3_clear_bindings(sqlite3_stmt*);
  3893   3893   
  3894   3894   /*
  3895   3895   ** CAPI3REF: Number Of Columns In A Result Set
  3896   3896   ** METHOD: sqlite3_stmt
  3897   3897   **
  3898   3898   ** ^Return the number of columns in the result set returned by the
  3899         -** [prepared statement]. ^This routine returns 0 if pStmt is an SQL
  3900         -** statement that does not return data (for example an [UPDATE]).
         3899  +** [prepared statement]. ^If this routine returns 0, that means the 
         3900  +** [prepared statement] returns no data (for example an [UPDATE]).
         3901  +** ^However, just because this routine returns a positive number does not
         3902  +** mean that one or more rows of data will be returned.  ^A SELECT statement
         3903  +** will always have a positive sqlite3_column_count() but depending on the
         3904  +** WHERE clause constraints and the table content, it might return no rows.
  3901   3905   **
  3902   3906   ** See also: [sqlite3_data_count()]
  3903   3907   */
  3904   3908   int sqlite3_column_count(sqlite3_stmt *pStmt);
  3905   3909   
  3906   3910   /*
  3907   3911   ** CAPI3REF: Column Names In A Result Set