PHP Manual
Prev |  | Next

# fbsql_read_clob

(PHP 4 CVS only)

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 teh 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().

Prev | Home | Next
fbsql_read_blob | Up | fbsql_result