English | 简体中文 | 繁體中文 | Русский язык | Français | Español | Português | Deutsch | 日本語 | 한국어 | Italiano | بالعربية

Tutorial básico PHP

Tutorial avançado PHP

PHP & MySQL

Manual de referência PHP

Uso e exemplo da função PHP mysqli_affected_rows()

PHP MySQLi Referência Manual

A função mysqli_affected_rows() obtém o número de linhas afetadas pela última operação MySQL.

Definição e uso

mysqli_affected_rows()A função tem o seguinte efeito: se for chamada após uma consulta INSERT, UPDATE, REPLACE ou DELETE, retorna o número de linhas afetadas pela operação anterior.

Esse função retorna o número de linhas após a cláusula select.

Sintaxe

mysqli_affected_rows($con)

Parâmetro

NúmeroParâmetros e descrição
1

con (obrigatório)

Este é um objeto que representa a conexão com o MySQL Server.

Valor de retorno

A função PHP mysqli_affected_rows() retorna um valor inteiro que indica o número de linhas afetadas pela operação anterior (SELECT, INSERT, UPDATE, REPLACE ou DELETE).

Se a consulta anterior tiver erro, essa função retorna -1. Se não houver linhas afetadas ou se a consulta anterior/A operação não é a consulta mencionada acima/Se uma das operações for executada, essa função retorna 0.

Versão do PHP

Essa função foi originalmente introduzida no PHP versão5introduzido no PHP e pode ser usado em todas as versões mais recentes.

Exemplo online

Os seguintes exemplos demonstrammysqli_affected_rows()Uso da função (estilo de programa)

<?php
　　　//Criar conexão
　　　$con = mysqli_connect("localhost", "root", "password", "mydb");
　　　//Consulta para recuperar todas as linhas da tabela employee
　　　mysqli_query($con, "SELECT　*　FROM employee");
　　　//Linhas afetadas
　　　$rows = mysqli_affected_rows($con);
　　　print("Número de linhas afetadas: ". $rows);
　　　//Fechar conexão
　　　mysqli_close($con);
?>

Resultados de saída

Número de linhas afetadas:　5

Exemplo online

Em estilo orientado a objetos, a sintaxe dessa função é $con -> affected_rows, onde $con É o objeto de conexão-

<?php
　　　//Criar conexão
　　　$con = new mysqli("localhost", "root", "password", "mydb");
　　　//Consulta para recuperar todas as linhas da tabela employee
　　　$con　-> query("SELECT　*　FROM employee");
　　　//Número de linhas afetadas
　　　$rows = $con　-> affected_rows;
　　　print("Número de linhas afetadas: ". $rows);
　　　//Fechar conexão
　　　$con　-> close();
?>

Resultados de saída

Número de linhas afetadas:　5

Exemplo online

Quando uma das seguintes condições se aplicar, vamos verificar o valor de retorno dessa função: não há consulta (especificada) e a consulta tem erro ou não afeta nenhuma linha:

<?php
　　　//Criar conexão
　　　$con = mysqli_connect("localhost", "root", "password", "mydb");
　　　$rows1　= mysqli_affected_rows($con);
　　　print("Linhas afetadas (ação não especificada anteriormente): ". $rows1".\n");
　　　//Consulta para recuperar todas as linhas da tabela employee
　　　mysqli_query($con, "SELECT　*　FORM employee");
　　　$rows2　= mysqli_affected_rows($con);
　　　print("Linhas afetadas (quando há erro na consulta): ". $rows2".\n");
　　　//Consulta para recuperar todas as linhas da tabela employee
　　　mysqli_query($con, "SELECT FIRST_NAME FROM employee WHERE AGE \<=19");
　　　$rows3　= mysqli_affected_rows($con);
　　　print("Linhas afetadas (quando a consulta não executa nenhuma operação): ". $rows3".\n");
　　　//Fechar conexão
　　　mysqli_close($con);
?>

Resultados de saída

Linhas afetadas (quando a operação não foi especificada anteriormente): 0
Linhas afetadas (quando a consulta tiver erro):　-1
Linhas afetadas (quando a consulta não executa nenhuma operação): 0

Exemplo online

Os seguintes exemplos demonstram SELECT, UPDATE, INSERT e DELETE consultasmysqli_affected_rowsUso da função-

<?php
　　　//Estabelecer conexão
　　　$con = mysqli_connect("localhost", "root", "password", "mydb");
　　　//Consulta para todas as linhas da tabela employee
　　　mysqli_query($con, "SELECT　*　FROM employee WHERE INCOME >　8000");
　　　print("Linhas afetadas pela consulta SELECT: ".mysqli_affected_rows($con)."\n");
　　　//Consulta para atualizar linhas na tabela employee
　　　mysqli_query($con, "UPDATE employee SET INCOME=INCOME+5000 WHERE FIRST_NAME IN ('Ramya', 'Trupthi', 'Sarmista')");
　　　print("Linhas afetadas pela consulta UPDATE: ".mysqli_affected_rows($con)."\n");
　　　//Consulta para inserir linhas na tabela employee
　　　mysqli_query($con, "INSERT INTO employee VALUES ('Archana', 'Mohonthy',　30, 'M',　13000,　106);
　　　print("Linhas afetadas pela consulta INSERT: ".mysqli_affected_rows($con)."\n");
　　　//Consulta para excluir linhas da tabela employee
　　　mysqli_query($con, "DELETE FROM employee WHERE AGE >　25");
　　　print("Linhas afetadas pela consulta DELETE: ".mysqli_affected_rows($con)."\n");
　　　//Fechar conexão
　　　mysqli_close($con);
?>

Resultados de saída

Linhas afetadas pela consulta SELECT:　4
Linhas afetadas pela consulta UPDATE:　3
Linhas afetadas pela consulta INSERT:　1
Linhas afetadas pela consulta DELETE:　3

PHP MySQLi Referência Manual

Funções CURL PHPFunções OpenSSL PHP