Возвращет число затронутых строк в предыдущем FrontBase действии


(PHP 4 >= 4.0.6, PHP 5)

fbsql_affected_rowsВозвращет число затронутых строк в предыдущем FrontBase действии

Описание

int fbsql_affected_rows ([ resource $link_identifier ] )

fbsql_affected_rows() возвращает число затронутых строк в последнем INSERT, UPDATE или DELETE запросе, связанным с link_identifier.

Замечание:

Если используются транзакции, то нужно вызвать fbsql_affected_rows() после INSERT, UPDATE, или DELETE запроса, но не после коммита.

Если последний запрос был DELETE запросом без условий в WHERE, то все записи будут удалены из таблицы, функция вернет 0.

Замечание:

Если используется UPDATE, то FrontBase не обновит столбцы, где новое значение идентично предыдущему значению. Это создает вероятность, что fbsql_affected_rows() может фактически не быть равной числу соответвующих строк, только число строк, которые были буквально затронуты запросом.

Список параметров

link_identifier

Идентификатор соединения FrontBase, полученный из fbsql_connect() или fbsql_pconnect().

Если он не был указан, то функция попытается найти открытое соединение к серверу FrontBase, в случае неудачи попытается создать новое, как если бы fbsql_connect() была вызвана без аргументов.

Возвращаемые значения

Если последний запрос не был произведен, то функция возвращает -1.

Смотрите также