pg_convert

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

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

    Описание

    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() - Удаляет записи
    To Top