ラージオブジェクトを書く

# pg_lo_write

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

pg_lo_write — ラージオブジェクトを書く

### 説明

pg_lo_write ( resource `$large_object` , string `$data` [, int `$len` ] ) : int

pg_lo_write() は、ラージオブジェクトの カレントのシーク位置にデータを書き込みます。

ラージオブジェクトインターフェイスは、トランザクションブロックの中で 使用する必要があります。

> 注意:

> この関数は、以前は pg_lowrite() と呼ばれていました。

### パラメータ

`large_object`

  pg_lo_open() によって返された PostgreSQL ラージオブジェクト (LOB) リソース。

`data`

  ラージオブジェクトに書き込むデータ。`len` が `data` の長さより小さく指定されている場合、 `len` バイトのみが書き込まれます。

`len`

  書き込むデータの最大バイト数（オプション）。0 より大きく、かつ `data` のサイズ以下でなければなりません。 デフォルトは `data` の長さです。

### 返り値

ラージオブジェクトに書き込んだバイト数を返します。 エラー時には `FALSE` を返します。

### 例

例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() - ラージオブジェクトをオープンする