Home/ Manual/ pgsql / functions/ pg_affected_rows

pg_affected_rows

PHP function Edit on GitHub ✎

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

Returns number of affected records (tuples)

Description

pg_affected_rows(PgSql\Result $result): int

pg_affected_rows() returns the number of tuples (instances/records/rows) affected by INSERT, UPDATE, and DELETE queries.

The server also returns the number of SELECTed rows.

Note

This function used to be called pg_cmdtuples().

Parameters

result: Result

Return Values

The number of rows affected by the query. If no tuple is affected, it will return 0.

Changelog

Version	Description

Examples

pg_affected_rows() example

php

<?php
$result = pg_query($conn, "INSERT INTO authors VALUES ('Orwell', 2002, 'Animal Farm')");

$cmdtuples = pg_affected_rows($result);

echo $cmdtuples . " tuples are affected.\n";
?>

The above example will output:

output

1 tuples are affected.