[函数]ibase_affected_rows()函数—用法及示例

函数名：ibase_affected_rows()

适用版本：PHP 5, PHP 7

用法：ibase_affected_rows() 函数用于返回前一次执行的 INSERT、UPDATE 或 DELETE 语句所影响的行数。

语法：int ibase_affected_rows ( resource $link_identifier = NULL )

参数：

• link_identifier（可选）：表示一个连接标识符，如果未提供该参数，则使用最近打开的数据库连接。

返回值：返回前一次执行的 INSERT、UPDATE 或 DELETE 语句所影响的行数，如果没有受影响的行，则返回 -1。

示例：

<?php
// 连接到数据库
$db = ibase_connect('localhost:/path/to/database.fdb', 'username', 'password');

// 执行 UPDATE 语句
$query = ibase_query($db, "UPDATE customers SET email = 'newemail@example.com' WHERE id = 1");
if (!$query) {
    die('更新失败: ' . ibase_errmsg());
}

// 获取受影响的行数
$rows_affected = ibase_affected_rows($db);
echo "受影响的行数：" . $rows_affected;

// 关闭数据库连接
ibase_close($db);
?>

输出：

受影响的行数：1

注意事项：

• ibase_affected_rows() 函数仅适用于 InterBase 数据库。
• 在执行 INSERT 语句时，返回的行数是受影响的行数，即插入的行数。
• 在执行 UPDATE 或 DELETE 语句时，返回的行数是受影响的行数，即更新或删除的行数。
• 如果没有受影响的行，函数将返回 -1。
• 如果未提供连接标识符参数，则将使用最近打开的数据库连接。
• 如果在执行查询之前未打开数据库连接，则函数将返回 FALSE。