fbsql_read_clob

Read a CLOB from the database

&reftitle.description; `string` `fbsql_read_clob` `string` `clob_handle` `resource` `link_identifier`

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.

&reftitle.parameters;

`clob_handle`

- A CLOB handle, returned by `fbsql_create_clob`.

&fbsql.link-identifier.description;
&reftitle.returnvalues;

Returns a string containing the specified CLOB data.

&reftitle.examples;

### `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);

    ?>

&reftitle.seealso;

- `fbsql_create_clob`
- `fbsql_read_blob`
- `fbsql_set_lob_mode`