array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'pdostatement.rowcount.php', 1 => 'PDOStatement::rowCount', 2 => 'Retorna o número de registros afetados pela última instrução SQL', ), 'up' => array ( 0 => 'class.pdostatement.php', 1 => 'PDOStatement', ), 'prev' => array ( 0 => 'pdostatement.nextrowset.php', 1 => 'PDOStatement::nextRowset', ), 'next' => array ( 0 => 'pdostatement.setattribute.php', 1 => 'PDOStatement::setAttribute', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/pdo/pdostatement/rowcount.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

PDOStatement::rowCount

(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.1.0)

PDOStatement::rowCount — Retorna o número de registros afetados pela última instrução SQL

Descrição

public PDOStatement::rowCount(): int

PDOStatement::rowCount() retorna o número de registros afetados pela última instrução DELETE, INSERT ou UPDATE executada pelo objeto PDOStatement correspondente.

Para instruções que produzem conjuntos de resultados, como SELECT, o comportamento é indefinido e pode ser diferente para cada driver. Alguns bancos de dados podem retornar o número de registros produzidos por essa instrução (por exemplo, MySQL em modo buffer), mas este comportamento não é garantido para todos os bancos de dados e não deve ser uma fonte confiável para aplicações portáveis.

Nota:

Este método retorna "0" (zero) com o driver PostgreSQL ao definir o atributo de instrução PDO::ATTR_CURSOR para PDO::CURSOR_SCROLL.

Parâmetros

Esta função não possui parâmetros.

Valor Retornado

Retorna o número de registros.

Erros/Exceções

Emite um erro de nível E_WARNING se o atributo PDO::ATTR_ERRMODE estiver definido como PDO::ERRMODE_WARNING.

Lança uma exceção PDOException se o atributo PDO::ATTR_ERRMODE estiver definido como PDO::ERRMODE_EXCEPTION.

Exemplos

Exemplo #1 Retorna o número de registros apagados

PDOStatement::rowCount() retorna o número de registros afetados pelas instruções DELETE, INSERT ou UPDATE.

<?php
/* Apaga todos os registros da tabela FRUIT */
$del = $dbh->prepare('DELETE FROM fruit');
$del->execute();

/* Retorna o número de registros apagados */
print "Número retornado de registros apagados:\n";
$count = $del->rowCount();
print "$count registros apagados.\n";
?>

O exemplo acima produzirá algo semelhante a:

Número retornado de registros apagados:
9 registros apagados.

Exemplo #2 Contando registros retornados por uma instrução SELECT

Para a maioria dos bancos de dados, o método PDOStatement::rowCount() não retorna o número de registros afetados por uma instrução SELECT. Ao invés dele, o método PDO::query() deve ser usado para emitir uma instrução SELECT COUNT(*) com os mesmos predicados da instrução SELECT requerida, e então PDOStatement::fetchColumn() deve ser usado para recuperar o número de registros correspondentes.

<?php
$sql = "SELECT COUNT(*) FROM fruit WHERE calories > 100";
$res = $conn->query($sql);
$count = $res->fetchColumn();

print "Há " . $count . " registros correspondentes.";

O exemplo acima produzirá algo semelhante a:

Há 2 registros correspondentes.

Veja Também