HIVE hosting - PHP: mysql_affected

Руководство по PHP
Пред.		След.

Описание

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"); ?>
Вышеописанный пример выдаст следующий результат:
Updated Records: 10

См. также mysql_num_rows(), mysql_info().

Пред.	Начало	След.
Функции СУБД MySQL	Уровень выше	mysql_change_user