ocinewcursor()函式—用法及示例

函式名稱：ocinewcursor()

函式描述：ocinewcursor() 函式用於建立一個新的遊標。

適用版本：PHP 4, PHP 5, PHP 7

語法：resource ocinewcursor ( resource $connection )

引數：

• $connection：一個有效的 Oracle 連線識別符號，由 oci_connect() 或 oci_pconnect() 返回。

返回值：成功時返回一個新的遊標資源，失敗時返回 FALSE。

示例：

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

// 檢查連線是否成功
if (!$conn) {
    $e = oci_error();
    trigger_error(htmlentities($e['message'], ENT_QUOTES), E_USER_ERROR);
}

// 建立一個新的遊標
$cursor = ocinewcursor($conn);

// 執行一個查詢語句
$stid = oci_parse($conn, 'SELECT * FROM employees');
oci_execute($stid);

// 將查詢結果繫結到遊標上
oci_bind_by_name($cursor, ':result', $result, -1, OCI_B_CURSOR);

// 執行遊標查詢
oci_execute($cursor);

// 迴圈遍歷遊標結果集
while (($row = oci_fetch_array($cursor, OCI_ASSOC)) != false) {
    // 處理每一行資料
    echo $row['EMPLOYEE_ID'] . " - " . $row['EMPLOYEE_NAME'] . "<br>";
}

// 關閉遊標
oci_free_statement($cursor);

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

注意事項：

• 在使用 ocinewcursor() 函式之前，必須先建立一個有效的 Oracle 連線。
• 建立遊標後，可以使用 oci_bind_by_name() 函式將查詢結果繫結到遊標上。
• 使用 oci_execute() 函式執行遊標查詢，並使用 oci_fetch_array() 函式迴圈遍歷遊標結果集。
• 最後，記得使用 oci_free_statement() 函式關閉遊標，並使用 oci_close() 函式關閉連線。