[函数]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。
• 如果提供了有效的链接标识符参数，则该函数将使用指定的链接执行查询，否则将使用最近的链接。
• 在多个查询执行后，该函数只能获取到最后一次查询的受影响行数。如果需要获取之前的查询受影响行数，应该在每次查询后立即调用该函数并保存结果。