(PHP 3, PHP 4, PHP 5)
mysql_affected_rows -- Obtém o número de linhas atingidas na operação anterior do MySQLObtém o número de linhas atingidas pela consulta INSERT, UPDATE, REPLACE ou DELETE mais recente associada ao link_identifier.
The MySQL connection. If the link identifier is not specified, the last link opened by mysql_connect() is assumed. If no such link is found, it will try to create one as if mysql_connect() was called with no arguments. If by chance no connection is found or established, an E_WARNING level warning is generated.
Retona o número de linas atingidas em caso de sucesso, e -1 se a ultima consulta falhou.
Se a ultima consulta foi um consulta DELETE sem a claúsula WHERE, todos os registros terão sido excluídos da tabela mas esta função irá retornar zero com versões do MySQL anteriores a 4.1.2.
Ao usar UPDATE, o MySQL não irá atualizar colunas aonde o novo valor é o mesmo que o valor anterior. Isto cria a possibilidade de que mysql_affected_rows() possa não ser igual ao número de linhas encontradas, apenas o número de linhas que literalmente foram afetadas pela consulta.
O comando REPLACE primeiro exclui o registro com a mesma chave primaria e então insere o novo registro. Esta função retorna o número de registros excluídos mais o número de registros inseridos.
Exemplo 2. Exemplo de mysql_affected_rows() usando transações
O exemplo acima irá imprimir algo similar a:
|
Transações: Se você estiver usando transações, você deve utilizar mysql_affected_rows() depois da sua consulta INSERT, UPDATE, ou DELETE, não depois de COMMIT.
Comandos SELECT: Para obter o número de linhas retornados por um SELECT, é possível usar mysql_num_rows().