查看“Better-sqlite3 绑定参数”的源代码


本节指的是文档中任何指定可选参数[''<code>...bindParameters</code>'']的地方。

<br>

有许多方法可以将参数绑定到预处理语句。最简单的方法是使用匿名参数：

<syntaxhighlight lang="js">const stmt = db.prepare('INSERT INTO people VALUES (?, ?, ?)');

// 以下等价。
stmt.run('John', 'Smith', 45);
stmt.run(['John', 'Smith', 45]);
stmt.run(['John'], ['Smith', 45]);</syntaxhighlight>
<br>

你也可以使用命名参数。SQLite3提供了[https://www.sqlite.org/lang_expr.html 3种不同的命名参数语法]（<code>@foo</code>，<code>:foo</code>和<code>$foo</code>），所有这些都由<code>better-sqlite3</code>支持。

<syntaxhighlight lang="js">// 以下等价。
const stmt = db.prepare('INSERT INTO people VALUES (@firstName, @lastName, @age)');
const stmt = db.prepare('INSERT INTO people VALUES (:firstName, :lastName, :age)');
const stmt = db.prepare('INSERT INTO people VALUES ($firstName, $lastName, $age)');
const stmt = db.prepare('INSERT INTO people VALUES (@firstName, :lastName, $age)');

stmt.run({
  firstName: 'John',
  lastName: 'Smith',
  age: 45
});</syntaxhighlight>
<br>

下面是一个将匿名参数与命名参数混合的例子。

<syntaxhighlight lang="js">const stmt = db.prepare('INSERT INTO people VALUES (@name, @name, ?)');
stmt.run(45, { name: 'Henry' });</syntaxhighlight>
<br>

这里是<code>better-sqlite3</code>如何将SQLite3和JavaScript之间的值进行转换的示例：

{| class="wikitable"
|-
! SQLite3
! JavaScript
|-
| <code>NULL</code>
| <code>null</code>
|-
| <code>REAL</code>
| <code>number</code>
|-
| <code>INTEGER</code>
| <code>number</code> [https://github.com/JoshuaWise/better-sqlite3/blob/master/docs/integer.md#the-bigint-primitive-type 或 <code>BigInt</code>]
|-
| <code>TEXT</code>
| <code>string</code>
|-
| <code>BLOB</code>
| [https://nodejs.org/api/buffer.html#buffer_class_buffer <code>Buffer</code>]
|}

<br>