pg_affected_rows
(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_affected_rows — Retorna o número de registros afetados (tuplas)
Descrição
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.
Note:
Esta função costumava ser chamada de pg_cmdtuples().
Parâmetros
result-
Uma instância de PgSql\Result, retornada por pg_query(), pg_query_params() ou pg_execute() (entre outras).
Valor Retornado
O número de linhas afetadas pela consulta. Se nenhuma tupla for
afetada, retornará 0.
Registro de Alterações
| Versão | Descrição |
|---|---|
| 8.1.0 |
O parâmetro result agora espera uma instância de PgSql\Result;
anteriormente, um resource era esperado.
|
Exemplos
Example #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.
Veja Também
- pg_query() - Executa uma consulta
- pg_query_params() - Envia um comando ao servidor e aguarda o resultado, com a capacidade de passar parâmetros separadamente do texto do comando SQL
- pg_execute() - Envia uma solicitação para executar uma instrução preparada com determinados parâmetros e aguarda o resultado
- pg_num_rows() - Retorna o número de linhas em um resultado