Преобразовывает значения ассоциативного массива в вид, который соответствует SQL-запросам

# pg_convert

(PHP 4 >= 4.3.0, PHP 5, PHP 7, PHP 8)

pg_convert — Преобразовывает значения ассоциативного массива в вид, который соответствует SQL-запросам

### Описание

function pg_convert(
PgSql\Connection `$connection`,
string `$table_name`,
array `$values`,
int `$flags` = 0
): array|false

Функция 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);

    ?>

### Смотрите также

- pg_meta_data() - Получение метаданных таблицы
- pg_insert() - Заносит данные массива в таблицу базы данных
- pg_select() - Выбирает записи из базы данных
- pg_update() - Обновление данных в таблице
- pg_delete() - Удаляет записи

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open