pg_affected_rows

Returns number of affected records (tuples)

&reftitle.description; `int` `pg_affected_rows` `PgSql\Result` `result`

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

Since PostgreSQL 9.0 and above, the server returns the number of SELECTed rows. Older PostgreSQL return 0 for SELECT.

This function used to be called `pg_cmdtuples`.

&reftitle.parameters;

`result`

- &pgsql.parameter.result;
&reftitle.returnvalues;

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

&reftitle.changelog;

&Version; | &Description;
&pgsql.changelog.result-object;

&reftitle.examples;

### `pg_affected_rows` example

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

    $cmdtuples = pg_affected_rows($result);

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

&example.outputs;

    1 tuples are affected.

&reftitle.seealso;

- `pg_query`
- `pg_query_params`
- `pg_execute`
- `pg_num_rows`