fbsql_read_clob

(PHP 4 >= 4.2.0, PHP 5)

fbsql_read_clob -- Read a CLOB from the database

Description

string fbsql_read_clob ( string clob_handle [, resource link_identifier])

Returns: A string containing the CLOB specified by clob_handle.

fbsql_read_clob() reads CLOB data from the database. If a select statement contains BLOB and/or CLOB columns FrontBase will return the data directly when data is fetched. This default behavior can be changed with fbsql_set_lob_mode() so the fetch functions will return handles to BLOB and CLOB data. If a handle is fetched a user must call fbsql_read_clob() to get the actual CLOB data from the database.

Example 1. fbsql_read_clob() example

<?php
    $link
= fbsql_pconnect("localhost", "_SYSTEM", "secret")
        or die(
"Could not connect");
    
$sql = "SELECT CLOB_COLUMN FROM CLOB_TABLE;";
    
$rs = fbsql_query($sql, $link);
    
$row_data = fbsql_fetch_row($rs);
    
// $row_data[0] will now contain the clob data for the first row
    
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] will now contain a handle to the CLOB data in the first row
    
$clob_data = fbsql_read_clob($row_data[0]);
    
fbsql_free_result($rs);
    
?>

See also: fbsql_create_blob(), fbsql_read_blob(), fbsql_read_clob(), and fbsql_set_lob_mode().