oci_num_rows()函式—用法及示例

函式名：oci_num_rows()

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

函式說明：oci_num_rows() 函式用於獲取最後一次執行的 SELECT 語句所返回的行數。

語法：oci_num_rows(resource $statement): int|false

引數：

• $statement：一個有效的 OCI 語句資源，通常是透過 oci_parse() 函式返回的結果。

返回值：

• 如果 SELECT 語句執行成功，返回結果集中的行數。
• 如果 SELECT 語句執行失敗或者沒有查詢結果，返回 FALSE。

示例：

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

// 準備查詢語句
$query = 'SELECT * FROM employees WHERE department_id = :dept_id';
$statement = oci_parse($conn, $query);

// 繫結引數
$dept_id = 10;
oci_bind_by_name($statement, ':dept_id', $dept_id);

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

// 獲取行數
$row_count = oci_num_rows($statement);

if ($row_count !== false) {
    echo "查詢結果中共有 {$row_count} 行資料。\n";
} else {
    echo "查詢失敗或者沒有查詢結果。\n";
}

// 關閉連線和釋放資源
oci_free_statement($statement);
oci_close($conn);

上述示例中，首先使用 oci_connect() 函式建立與 Oracle 資料庫的連線。接著，透過 oci_parse() 函式準備一個查詢語句，並使用 oci_bind_by_name() 函式繫結引數。然後，使用 oci_execute() 函式執行查詢語句。最後，透過 oci_num_rows() 函式獲取查詢結果的行數，並根據返回值判斷是否成功獲取到行數。最後，使用 oci_free_statement() 函式釋放語句資源，並使用 oci_close() 函式關閉資料庫連線。