pg_affected_rows

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_affected_rows Devuelve el número de filas afectadas

Descripción

pg_affected_rows(PgSql\Result $result): int

pg_affected_rows() devuelve el número de filas afectadas por las consultas de tipo INSERT, UPDATE y DELETE.

Desde PostgreSQL 9.0 y versiones posteriores, el servidor devuelve el número de filas seleccionadas. Para las versiones anteriores, PostgreSQL devuelve 0 para las SELECT.

Nota:

Anteriormente, esta función se llamaba pg_cmdtuples().

Parámetros

result

Una instancia PgSql\Result, devuelta por pg_query(), pg_query_params(), o pg_execute() (entre otros).

Valores devueltos

El número de filas afectadas por la consulta. Si no hay tuplas afectadas, la función devolverá 0.

Historial de cambios

Versión Descripción
8.1.0 El parámetro result ahora espera una instancia de PgSql\Result ; anteriormente, se esperaba un resource.

Ejemplos

Ejemplo #1 Ejemplo con pg_affected_rows()

<?php
$result
= pg_query($conn, "INSERT INTO editeur VALUES ('Auteur')");

$cmdtuples = pg_affected_rows($result);

echo
$cmdtuples . " filas han sido afectadas.\n";
?>

El ejemplo anterior mostrará :

1 filas han sido afectadas.

Ver también

  • pg_query() - Ejecuta una consulta PostgreSQL
  • pg_query_params() - Envía un comando al servidor y espera el resultado, con la capacidad de pasar parámetros por separado del texto SQL de la consulta
  • pg_execute() - Ejecuta una consulta preparada de PostgreSQL
  • pg_num_rows() - Devuelve el número de filas de PostgreSQL