PostgreSQL 関数

pg_lo_write

(PHP 4 >= 4.2.0, PHP 5)

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

説明

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

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

参考

PostgreSQL 関数