(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_lo_write — Записывает данные в большой объект
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.0 |
length теперь допускает значение 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");
?>