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

An PgSql\Result instance, returned by pg_query(), pg_query_params() or pg_execute()(among others).

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 The result parameter expects an PgSql\Result instance now; previously, a recurso was expected.

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 resultado del ejemplo sería:

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