SQLite: Check-in [0593373d]

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

Overview

Comment:	Improved documentation of the sqlite3_column_count() and sqlite3_data_count() interfaces.
Downloads:	Tarball \| ZIP archive \| SQL archive
Timelines:	family \| ancestors \| descendants \| both \| trunk
Files:	files \| file ages \| folders
SHA1:	0593373d4bf4f3451b41810513fd12cd8ebd0395
User & Date:	drh 2010-09-03 12:05:12

Context

2010-09-03
18:50		Documentation enhancements for sqlite3_db_status(). Evidence marks on the SQL function call intrface. (check-in: f06c7b19 user: drh tags: trunk)
12:05		Improved documentation of the sqlite3_column_count() and sqlite3_data_count() interfaces. (check-in: 0593373d user: drh tags: trunk)
10:58		Add a few more subquery tests to e_expr.test. (check-in: 189cba00 user: dan tags: trunk)

Changes

Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to src/sqlite.h.in.

  2812   2812   
  2813   2813   /*
  2814   2814   ** CAPI3REF: Number Of Columns In A Result Set
  2815   2815   **
  2816   2816   ** ^Return the number of columns in the result set returned by the
  2817   2817   ** [prepared statement]. ^This routine returns 0 if pStmt is an SQL
  2818   2818   ** statement that does not return data (for example an [UPDATE]).
         2819  +**
         2820  +** See also: [sqlite3_data_count()]
  2819   2821   */
  2820   2822   int sqlite3_column_count(sqlite3_stmt *pStmt);
  2821   2823   
  2822   2824   /*
  2823   2825   ** CAPI3REF: Column Names In A Result Set
  2824   2826   **
  2825   2827   ** ^These routines return the name assigned to a particular column
................................................................................
  3002   3004   ** by sqlite3_step().  The use of the "v2" interface is recommended.
  3003   3005   */
  3004   3006   int sqlite3_step(sqlite3_stmt*);
  3005   3007   
  3006   3008   /*
  3007   3009   ** CAPI3REF: Number of columns in a result set
  3008   3010   **
  3009         -** ^The sqlite3_data_count(P) the number of columns in the
  3010         -** of the result set of [prepared statement] P.
         3011  +** ^The sqlite3_data_count(P) interface returns the number of columns in the
         3012  +** current row of the result set of [prepared statement] P.
         3013  +** ^If prepared statement P does not have results ready to return
         3014  +** (via calls to the [sqlite3_column_int | sqlite3_column_*()] of
         3015  +** interfaces) then sqlite3_data_count(P) returns 0.
         3016  +** ^The sqlite3_data_count(P) routine also returns 0 if P is a NULL pointer.
         3017  +**
         3018  +** See also: [sqlite3_column_count()]
  3011   3019   */
  3012   3020   int sqlite3_data_count(sqlite3_stmt *pStmt);
  3013   3021   
  3014   3022   /*
  3015   3023   ** CAPI3REF: Fundamental Datatypes
  3016   3024   ** KEYWORDS: SQLITE_TEXT
  3017   3025   **