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