/ Check-in [9389e6a7]
Login

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

Overview
Comment:Attempt to clarify the meaning of a "parameter" in the sqlite3_bind() API documentation.
Downloads: Tarball | ZIP archive | SQL archive
Timelines: family | ancestors | descendants | both | trunk
Files: files | file ages | folders
SHA1: 9389e6a7dad7ba70923282d6fe45fbccd22f681e
User & Date: drh 2009-08-25 14:59:37
Context
2009-08-25
15:56
Initialize variables differently in the range processing logic of where.c in order to make sure variables are always initialized even following an OOM error. check-in: 3fb3686a user: drh tags: trunk
14:59
Attempt to clarify the meaning of a "parameter" in the sqlite3_bind() API documentation. check-in: 9389e6a7 user: drh tags: trunk
14:24
Make sure that the output of EXPLAIN is right when the P4 argument of an opcode is of type P4_MEM with the MEM having type MEM_Blob. check-in: 6a623e6c user: drh tags: trunk
Changes
Hide Diffs Side-by-Side Diffs Ignore Whitespace Patch

Changes to src/sqlite.h.in.

  2496   2496   
  2497   2497   /*
  2498   2498   ** CAPI3REF: Binding Values To Prepared Statements {H13500} <S70300>
  2499   2499   ** KEYWORDS: {host parameter} {host parameters} {host parameter name}
  2500   2500   ** KEYWORDS: {SQL parameter} {SQL parameters} {parameter binding}
  2501   2501   **
  2502   2502   ** In the SQL strings input to [sqlite3_prepare_v2()] and its variants,
  2503         -** literals may be replaced by a [parameter] in one of these forms:
         2503  +** literals may be replaced by a [parameter] that matches one of following
         2504  +** templates:
  2504   2505   **
  2505   2506   ** <ul>
  2506   2507   ** <li>  ?
  2507   2508   ** <li>  ?NNN
  2508   2509   ** <li>  :VVV
  2509   2510   ** <li>  @VVV
  2510   2511   ** <li>  $VVV
  2511   2512   ** </ul>
  2512   2513   **
  2513         -** In the parameter forms shown above NNN is an integer literal,
  2514         -** and VVV is an alpha-numeric parameter name. The values of these
         2514  +** In the templates above, NNN represents an integer literal,
         2515  +** and VVV represents an alphanumeric identifer.  The values of these
  2515   2516   ** parameters (also called "host parameter names" or "SQL parameters")
  2516   2517   ** can be set using the sqlite3_bind_*() routines defined here.
  2517   2518   **
  2518   2519   ** The first argument to the sqlite3_bind_*() routines is always
  2519   2520   ** a pointer to the [sqlite3_stmt] object returned from
  2520   2521   ** [sqlite3_prepare_v2()] or its variants.
  2521   2522   **