pg_lo_write

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

    pg_lo_write — Записывает данные в большой объект

    Описание

    pg_lo_write(PgSql\Lob$lob, string$data, ?int$length = null): int|false

    pg_lo_write() записывает данные в большой объект, начиная с текущей позиции внутреннего указателя.

    Операции с использованием интерфейса больших объектов необходимо заключать в блок транзакции.

    Замечание:

    Прежнее название функции: pg_lowrite().

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

    lob

    Экземпляр класса PgSql\Lob, который вернула функция pg_lo_open().

    data

    Данные для записи в большой объект. Если аргумент length задан и меньше размера data, то записаны будут только length байт.

    length

    Необязательный аргумент. Максимальное количество записываемых байт. Должен быть больше нуля и не превышать размер data. По умолчанию принимается равным размеру data.

    Возвращаемые значения

    Количество записанных в большой объект байт, либо false в случае возникновения ошибки.

    Список изменений

    ВерсияОписание
    8.1.0 Параметр lob теперь ожидает экземпляр класса PgSql\Lob; раньше параметр ждал ресурс (resource).
    8.0.0length теперь допускает значение null.

    Примеры

    Пример #1 Пример использования pg_lo_write()

    <?php
    $doc_oid     = 189762345;
    $data = "This will overwrite the start of the large object.";
    $database = pg_connect("dbname=jacarta");
    pg_query($database, "begin");
    $handle = pg_lo_open($database, $doc_oid, "w");
    $data = pg_lo_write($handle, $data);
    pg_query($database, "commit");
    ?>

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

    • pg_lo_create() - Создаёт большой объект
    • pg_lo_open() - Открывает большой объект базы данных
    To Top