fbird_affected()函式—用法及示例

函式名：fbird_affected()

適用版本：PHP 4 >= 4.2.0, PHP 5, PHP 7

函式描述：獲取前一次執行的 InterBase/Firebird 查詢所影響的行數

用法： int fbird_affected ( resource $link_identifier = ? )

引數：

• $link_identifier（可選）：一個有效的資料庫連結資源識別符號，如果未提供，則使用最近的連結。

返回值：

• 返回前一次 InterBase/Firebird 查詢所影響的行數，如果沒有受到影響則返回 -1。

示例：

// 連線到資料庫
$link = fbird_connect("localhost:/path/to/database.fdb", "username", "password");

// 執行查詢
$query = "UPDATE users SET name = 'John' WHERE id = 1";
$result = fbird_query($link, $query);

// 獲取受影響的行數
$affectedRows = fbird_affected($link);

if ($affectedRows >= 0) {
    echo "成功更新了 " . $affectedRows . " 行資料。";
} else {
    echo "查詢未執行或未影響任何行。";
}

// 關閉資料庫連線
fbird_close($link);

注意事項：

• 該函式僅適用於 InterBase 和 Firebird 資料庫。
• 在使用該函式之前，必須先透過 fbird_query() 或 fbird_execute() 執行一條查詢語句。
• 如果查詢語句執行失敗或未影響任何行，則返回 -1。
• 如果提供了有效的連結識別符號引數，則該函式將使用指定的連結執行查詢，否則將使用最近的連結。
• 在多個查詢執行後，該函式只能獲取到最後一次查詢的受影響行數。如果需要獲取之前的查詢受影響行數，應該在每次查詢後立即呼叫該函式並儲存結果。