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

# pg_lo_write

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

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

### Описание

function 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.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");
    ?>

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

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

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