Описание
int
mysql_affected_rows ( [resource link_identifier] )
mysql_affected_rows() возвращает количество
рядов, затронутых последним INSERT, UPDATE, DELETE запросом
к серверу, на который ссылается указатель link_identifier. Если
ресурс не указан, функция использует последнее, успешное соединение,
выполненное с помощью функции mysql_connect().
Замечание:
При использовании транзакций mysql_affected_rows() надо вызывать
после INSERT, UPDATE, DELETE запроса, но не после подтверждения.
Если последний запрос был DELETE без указания WHERE и, соответственно,
таблица была очищена, функция вернёт ноль (0).
Замечание:
При использовании UPDATE, MySQL не обновит колонки, уже содержащие новое
значение. Вследствие этого, функция mysql_affected_rows()
не всегда возвращает количество рядов, подошедших по условия, только
количество рядов, обновлённых запросом.
mysql_affected_rows() не работает с SELECT -- только с
запросами, модифицирующими таблицу. Чтобы получить количество рядов,
возвращённых SELECT-запросом, используйте функцию
mysql_num_rows().
Если последний запрос был неудачным, функция вернёт -1.
Пример 1. DELETE-запрос
<?php
/* соединямеся с базой данных */
mysql_pconnect("localhost", "mysql_user", "mysql_password") or
die("Could not connect: " . mysql_error());
mysql_select_db("mydb");
/* здесь функция вернёт корректное число удалённых записей */
mysql_query("DELETE FROM mytable WHERE id < 10");
printf ("Records deleted: %d\n", mysql_affected_rows());
/* без указания WHERE в запросе, функция всегда возвращает 0 */
mysql_query("DELETE FROM mytable");
printf ("Records deleted: %d\n", mysql_affected_rows());
?>
|
Вышеописанный пример выдаст следующий результат:
Records deleted: 10
Records deleted: 0 |
|
Пример 2. UPDATE-запрос
<?php
/* соединямеся с базой данных */
mysql_pconnect("localhost", "mysql_user", "mysql_password") or
die("Could not connect: " . mysql_error());
mysql_select_db("mydb");
/* Обновляем ряды */
mysql_query("UPDATE mytable SET used=1 WHERE id < 10");
printf ("Updated records: %d\n", mysql_affected_rows());
mysql_query("COMMIT");
?>
|
Вышеописанный пример выдаст следующий результат:
|
См. также mysql_num_rows(),
mysql_info().