OCILob::rewind()函式—用法及示例

函式名稱：OCILob::rewind()

適用版本：PHP 5, PHP 7

函式描述：OCILob::rewind() 函式用於將 LOB 資料指標重新定位到起始位置。

語法：bool OCILob::rewind ( resource $lob_descriptor )

引數：

• $lob_descriptor：一個有效的 LOB 描述符（由 OCILob::load() 或 OCILob::newDescriptor() 函式返回）。

返回值：如果成功，該函式返回 TRUE，否則返回 FALSE。

示例：

// 建立一個新的連線
$conn = oci_connect('username', 'password', 'localhost/XE');

// 準備一個查詢語句
$sql = 'SELECT clob_column FROM my_table WHERE id = :id';

// 準備一個語句控制代碼
$stmt = oci_parse($conn, $sql);

// 繫結引數
$id = 1;
oci_bind_by_name($stmt, ':id', $id);

// 執行查詢
oci_execute($stmt);

// 獲取 LOB 資料
while (($row = oci_fetch_assoc($stmt)) !== false) {
    // 建立一個 LOB 描述符
    $lob_descriptor = oci_new_descriptor($conn, OCI_D_LOB);

    // 將 LOB 資料從結果集中讀取到 LOB 描述符中
    oci_lob_copy($lob_descriptor, $row['CLOB_COLUMN']);

    // 將 LOB 資料指標重新定位到起始位置
    $result = $lob_descriptor->rewind();

    if ($result === true) {
        echo 'LOB 資料指標已成功重新定位到起始位置。';
    } else {
        echo 'LOB 資料指標重新定位失敗。';
    }

    // 釋放 LOB 描述符
    $lob_descriptor->free();
}

// 關閉連線
oci_close($conn);

注意事項：

• 在使用 OCILob::rewind() 函式之前，必須先從結果集中讀取 LOB 資料到 LOB 描述符中。
• OCILob::rewind() 函式只適用於 CLOB 和 NCLOB 型別的 LOB 資料。
• OCILob::rewind() 函式在 PHP 5 和 PHP 7 中都可用。