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

函式名稱：OCILob::write()

適用版本：PHP 5, PHP 7

函式描述：該函式用於向Oracle LOB（Large Object）物件中寫入資料。

語法：bool OCILob::write(resource $lob, string $data [, int $length])

引數：

• $lob：表示Oracle LOB物件的資源控制代碼。
• $data：要寫入LOB物件的資料。
• $length（可選）：指定要寫入的資料長度，如果未提供該引數，則預設為寫入所有資料。

返回值：成功寫入資料時返回 true，寫入失敗時返回 false。

示例：

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

if (!$conn) {
    $e = oci_error();
    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}

// 準備一個LOB物件
$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物件
if ($row = oci_fetch_assoc($stmt)) {
    $lob = $row['CLOB_COLUMN'];
} else {
    die("LOB object not found");
}

// 向LOB物件寫入資料
$data = "This is some text to be written into the LOB object.";
if (OCILob::write($lob, $data)) {
    echo "Data written successfully.";
} else {
    echo "Failed to write data.";
}

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

上述示例演示瞭如何使用OCILob::write()函式向Oracle LOB物件中寫入資料。首先，我們建立了一個資料庫連線。然後，我們執行一個SELECT查詢來獲取包含LOB物件的結果集。接下來，我們透過OCI函式獲取到LOB物件，並將其賦值給變數$lob。最後，我們呼叫OCILob::write()函式來向LOB物件中寫入資料，並根據返回值判斷寫入是否成功。