fbsql_read_clob
(PHP 4 >= 4.2.0, PHP 5, PHP 7)
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() - CLOB を作成する
- fbsql_read_blob() - データベースから BLOB を読み込む
- fbsql_set_lob_mode() - FrontBase 結果セットの LOB 取得モードを設定する
忘却曲線を使ってこの関数を確実に記憶に残す
