« SQLite3Stmt::bindParamSQLite3Stmt::clear »PHP ManualSQLite3Stmt

SQLite3Stmt::bindValue

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

SQLite3Stmt::bindValue — Зв'язує значення параметра зі змінною підготовленого запиту

Опис

public SQLite3Stmt::bindValue(string|int $param, mixed $value, int $type = SQLITE3_TEXT): bool

Зв'язує значення параметра зі змінною підготовленого запиту.

Застереження

До PHP 7.2.14 та 7.3.0, якщо виконано запит, необхідно викликати метод SQLite3Stmt::reset() щоб можна було змінити значення пов'язаних параметрів.

Список параметрів

param

Або рядок (string) (для іменованих параметрів), або ціле число (int) (для позитивних параметрів), що ідентифікує змінну підготовленого запиту, якого має бути прив'язане значення. Якщо іменований параметр не починається з двокрапки (( : )) або знаку @, автоматично додається двокрапка ( : ). Позитивні параметри починаються з першого.

value

Значення прив'язки до змінної підготовленого запиту.

type

Тип даних для прив'язки.

  • SQLITE3_INTEGER: Значення є цілим числом зі знаком, яке зберігається в 1, 2, 3, 4, 6 або 8 байт, залежно від величини значення.

  • SQLITE3_FLOAT: Значення є числом з плаваючою точкою, яке зберігається у вигляді 8-байтного числа IEEE з плаваючою точкою.

  • SQLITE3_TEXT: Значення є текстовим рядком, який зберігається в кодуванні бази даних (UTF-8, UTF-16BE або UTF-16-LE).

  • SQLITE3_BLOB: Значення є великим двійковим об'єктом (blob) даних, який зберігається так само, як і вхідні дані.

  • SQLITE3_NULL: Значення є значенням NULL.

У PHP 7.0.7, якщо type опущений, то він автоматично визначається з типу param: bool та int розглядаються як SQLITE3_INTEGER, float як SQLITE3_FLOAT, null як SQLITE3_NULL і всіх інших як SQLITE3_TEXTРаньше, если тип опущен, он по умолчанию использовалсяSQLITE3_TEXT

Зауваження :

Якщо paramравен**null**, він завжди обробляється як SQLITE3_NULL, независимо от заданногоtype

Значення, що повертаються

Повертає true, якщо параметр прив'язаний до змінної підготовленого запиту або **false**в случае возникновения ошибки.

список змін

ВерсияОпис
7.4.0Параметрparam тепер підтримує нотацію @param

Приклади

Приклад #1 Приклад використання SQLite3Stmt::bindValue()****

Loading...

Результат виконання наведеного прикладу:

array(1) {
  ["bar"]=>
  string(14) "This is a test"
}

Дивіться також