Учебник PHP
mysql_affected_rows
(PHP 3, PHP 4)
mysql_affected_rows - получает количество рядов, задействованных в предыдущей MySQL-операции.
Описание
int mysql_affected_rows ([resource link_identifier])
mysql_affected_rows() возвращает количество рядов, задействованных в последнем запросе INSERT, UPDATE или DELETE, ассоциированном с идентификатором link_identifier. Если link identifier не специфицирован, принимается последняя ссылка, открытая функцией mysql_connect().
Примечание: если вы используете транзакции, необходимо вызывать mysql_affected_rows() после запроса INSERT, UPDATE или DELETE, а не после подтверждения транзакции.
Если последним запросом был DELETE без оператора WHERE, все записи таблицы будут удалены, но функция возвратит нуль.
Примечание: при использовании UPDATE, MySQL не обновит столбцы, где новое значение - такое же, как и старое. Это создаёт возможность того, что mysql_affected_rows() совпадёт не с количеством рядов, задействованных реально, а только с рядами, непосредственно изменёнными запросом.
mysql_affected_rows() не работает с операторами SELECT; только с операторами, модифицирующими запись. Для запрашивания количества рядов, возвращённых SELECT, используйте mysql_num_rows().
Если последний запрос потерпел неудачу, эта функция возвратит -1.
