(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)
pg_convert — Преобразовывает значения ассоциативного массива в вид, который соответствует SQL-запросам
$connection
,$table_name
,$values
,$flags
= 0
Функция pg_convert() проверяет и преобразовывает значения
массива values
в значения, которые соответствуют формату SQL-выражения.
Предварительное условие функции pg_convert() —
таблица table_name
должна существовать, а количество колонок
в таблице должно быть не меньше количества значений в массиве values
.
Имена колонок в таблице table_name
должны совпадать
с ключами массива values
, типы данных значений массива
также должны совпадать с типами данных колонок. В случае удачной
конвертации функция возвращает массив преобразованных значений, иначе возвращает false
.
Замечание:
Логические значения преобразовываются в логический тип СУБД PostgreSQL. Поддерживаются также строковые представления логического значения. Значение
null
преобразовывается в значения NULL СУБД PostgreSQL.
connection
Экземпляр класса PgSql\Connection.
table_name
Имя таблицы базы данных.
values
Данные для преобразования.
flags
Одна или комбинация констант PGSQL_CONV_IGNORE_DEFAULT
,
PGSQL_CONV_FORCE_NULL
или
PGSQL_CONV_IGNORE_NOT_NULL
.
Функция возвращает массив (array),
который содержит преобразованные данные или false
, если возникла ошибка.
Функция выбрасывает исключение ValueError или TypeError, если значение или тип поля не соответствует правильному типу СУБД PostgreSQL.
Версия | Описание |
---|---|
8.3.0 |
Функция теперь выбрасывает исключение ValueError
или TypeError,
если значение или тип поля не соответствуют правильному типу СУБД PostgreSQL;
раньше функция выдавала ошибку уровня E_WARNING .
|
8.1.0 |
Параметр connection теперь ожидает экземпляр
класса PgSql\Connection; раньше параметр ожидал ресурс (resource).
|
Пример #1 Пример использования функции pg_convert()
<?php
$dbconn = pg_connect('dbname=foo');
$tmp = array(
'author' => 'Joe Thackery',
'year' => 2005,
'title' => 'My Life, by Joe Thackery'
);
$vals = pg_convert($dbconn, 'authors', $tmp);
?>