(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_affected_rows — Retorna o número de registros afetados (tuplas)
pg_affected_rows() retorna o número de tuplas
(instâncias/registros/linhas) afetadas pelas consultas
INSERT
, UPDATE
e
DELETE
.
Desde o PostgreSQL 9.0 e superior, o servidor retorna o número de linhas SELECTed. PostgreSQL mais antigo retorna 0 para SELECT.
Nota:
Esta função costumava ser chamada de pg_cmdtuples().
result
Uma instância de PgSql\Result, retornada por pg_query(), pg_query_params() ou pg_execute() (entre outras).
O número de linhas afetadas pela consulta. Se nenhuma tupla for
afetada, retornará 0
.
Versão | Descrição |
---|---|
8.1.0 |
O parâmetro result agora espera uma instância de PgSql\Result;
anteriormente, um resource era esperado.
|
Exemplo #1 Exemplo de pg_affected_rows()
<?php
$result = pg_query($conn, "INSERT INTO authors VALUES ('Orwell', 2002, 'Animal Farm')");
$cmdtuples = pg_affected_rows($result);
echo $cmdtuples . " tuplas são afetadas.\n";
?>
O exemplo acima produzirá:
1 tuplas são afetadas.