Skip to content

Commit 216b034

Browse files
araujoguiclaude
andcommitted
doc: clarify sqlite numbered parameters
Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
1 parent af289a3 commit 216b034

1 file changed

Lines changed: 55 additions & 2 deletions

File tree

‎doc/api/sqlite.md‎

Lines changed: 55 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -985,8 +985,9 @@ the parameters of the prepared statement before executing it. Parameters are
985985
either anonymous or named.
986986

987987
Anonymous parameters are written as `?` in SQL and are bound in order from the
988-
arguments passed to the method. The `?NNN` form assigns an explicit number to a
989-
placeholder, binding it to the argument at position `NNN`.
988+
arguments passed to the method. The `?NNN` form assigns SQLite parameter index
989+
`NNN` to a placeholder. Avoid mixing numbered and named parameters because they
990+
share parameter indexes.
990991

991992
```js
992993
db.prepare('SELECT ? AS a, ? AS b').get('x', 42);
@@ -1026,6 +1027,12 @@ bound. Binding any other value throws an `ERR_INVALID_ARG_TYPE` error.
10261027
<!-- YAML
10271028
added: v22.5.0
10281029
changes:
1030+
- version: REPLACEME
1031+
pr-url: https://github.com/nodejs/node/pull/62001
1032+
description: Add support for boolean values in bound parameters.
1033+
- version: REPLACEME
1034+
pr-url: https://github.com/nodejs/node/pull/62061
1035+
description: Add support for `ArrayBuffer` and `SharedArrayBuffer` objects in bound parameters.
10291036
- version:
10301037
- v23.7.0
10311038
- v22.14.0
@@ -1104,6 +1111,12 @@ execution of this prepared statement. This property is a wrapper around
11041111
<!-- YAML
11051112
added: v22.5.0
11061113
changes:
1114+
- version: REPLACEME
1115+
pr-url: https://github.com/nodejs/node/pull/62001
1116+
description: Add support for boolean values in bound parameters.
1117+
- version: REPLACEME
1118+
pr-url: https://github.com/nodejs/node/pull/62061
1119+
description: Add support for `ArrayBuffer` and `SharedArrayBuffer` objects in bound parameters.
11071120
- version:
11081121
- v23.7.0
11091122
- v22.14.0
@@ -1133,6 +1146,12 @@ added:
11331146
- v23.4.0
11341147
- v22.13.0
11351148
changes:
1149+
- version: REPLACEME
1150+
pr-url: https://github.com/nodejs/node/pull/62001
1151+
description: Add support for boolean values in bound parameters.
1152+
- version: REPLACEME
1153+
pr-url: https://github.com/nodejs/node/pull/62061
1154+
description: Add support for `ArrayBuffer` and `SharedArrayBuffer` objects in bound parameters.
11361155
- version:
11371156
- v23.7.0
11381157
- v22.14.0
@@ -1159,6 +1178,12 @@ the values in `namedParameters` and `anonymousParameters`. See
11591178
<!-- YAML
11601179
added: v22.5.0
11611180
changes:
1181+
- version: REPLACEME
1182+
pr-url: https://github.com/nodejs/node/pull/62001
1183+
description: Add support for boolean values in bound parameters.
1184+
- version: REPLACEME
1185+
pr-url: https://github.com/nodejs/node/pull/62061
1186+
description: Add support for `ArrayBuffer` and `SharedArrayBuffer` objects in bound parameters.
11621187
- version:
11631188
- v23.7.0
11641189
- v22.14.0
@@ -1297,6 +1322,13 @@ class execute synchronously.
12971322

12981323
<!-- YAML
12991324
added: v24.9.0
1325+
changes:
1326+
- version: REPLACEME
1327+
pr-url: https://github.com/nodejs/node/pull/62001
1328+
description: Add support for boolean values in bound parameters.
1329+
- version: REPLACEME
1330+
pr-url: https://github.com/nodejs/node/pull/62061
1331+
description: Add support for `ArrayBuffer` and `SharedArrayBuffer` objects in bound parameters.
13001332
-->
13011333

13021334
* `stringElements` {string\[]} Template literal elements containing the SQL
@@ -1315,6 +1347,13 @@ called directly.
13151347

13161348
<!-- YAML
13171349
added: v24.9.0
1350+
changes:
1351+
- version: REPLACEME
1352+
pr-url: https://github.com/nodejs/node/pull/62001
1353+
description: Add support for boolean values in bound parameters.
1354+
- version: REPLACEME
1355+
pr-url: https://github.com/nodejs/node/pull/62061
1356+
description: Add support for `ArrayBuffer` and `SharedArrayBuffer` objects in bound parameters.
13181357
-->
13191358

13201359
* `stringElements` {string\[]} Template literal elements containing the SQL
@@ -1333,6 +1372,13 @@ called directly.
13331372

13341373
<!-- YAML
13351374
added: v24.9.0
1375+
changes:
1376+
- version: REPLACEME
1377+
pr-url: https://github.com/nodejs/node/pull/62001
1378+
description: Add support for boolean values in bound parameters.
1379+
- version: REPLACEME
1380+
pr-url: https://github.com/nodejs/node/pull/62061
1381+
description: Add support for `ArrayBuffer` and `SharedArrayBuffer` objects in bound parameters.
13361382
-->
13371383

13381384
* `stringElements` {string\[]} Template literal elements containing the SQL
@@ -1350,6 +1396,13 @@ called directly.
13501396

13511397
<!-- YAML
13521398
added: v24.9.0
1399+
changes:
1400+
- version: REPLACEME
1401+
pr-url: https://github.com/nodejs/node/pull/62001
1402+
description: Add support for boolean values in bound parameters.
1403+
- version: REPLACEME
1404+
pr-url: https://github.com/nodejs/node/pull/62061
1405+
description: Add support for `ArrayBuffer` and `SharedArrayBuffer` objects in bound parameters.
13531406
-->
13541407

13551408
* `stringElements` {string\[]} Template literal elements containing the SQL

0 commit comments

Comments
 (0)