fbsql_read_clob

(PHP 4 >= 4.2.0, PHP 5)

fbsql_read_clob -- データベースから CLOB を読み込む

説明

string fbsql_read_clob ( string clob_handle [, resource link_identifier] )

データベースから CLOB データを読み込みます。

select 文が BLOB や CLOB のカラムを含んでいる場合、 FrontBase はデータが取得される際にはそのデータを直接返します。 このデフォルトの動作は fbsql_set_lob_mode() で変更することが可能で、そうするとデータの取得時には BLOB および CLOB データのハンドルを返します。ハンドルを取得した場合は、 データベースから実際の CLOB データを取得するために fbsql_read_clob() をコールする必要があります。

パラメータ

clob_handle

fbsql_create_clob() が返す CLOB ハンドル。

link_identifier

fbsql_connect() あるいは fbsql_pconnect() が返す FrontBase リンク ID。

指定しなかった場合は、この関数は FrontBase サーバでオープンしているリンクを探します。見つからないときは fbsql_connect() に引数を指定せずにコールしたときと同様にして作成します。

返り値

指定した CLOB データを含む文字列を返します。

例 1. fbsql_read_clob() の例

<?php
$link
= fbsql_pconnect("localhost", "_SYSTEM", "secret")
    or die(
"接続できません");
$sql = "SELECT CLOB_COLUMN FROM CLOB_TABLE;";
$rs = fbsql_query($sql, $link);
$row_data = fbsql_fetch_row($rs);
// $row_data[0] には最初の行の clob データが含まれています
fbsql_free_result($rs);

$rs = fbsql_query($sql, $link);
fbsql_set_lob_mode($rs, FBSQL_LOB_HANDLE);
$row_data = fbsql_fetch_row($rs);
// $row_data[0] には最初の行の CLOB データへのハンドルが含まれています
$clob_data = fbsql_read_clob($row_data[0]);
fbsql_free_result($rs);

?>

参考

fbsql_create_clob()
fbsql_read_blob()
fbsql_set_lob_mode()