pg_affected_rows

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

    pg_affected_rows — Returns number of affected records (tuples)

    Descrição

    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.

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

    Nota:

    This function used to be called 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

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

    Registro de Alterações

    VersãoDescrição
    8.1.0 O parâmetro result agora espera uma instância de PgSql\Result; anteriormente, um resource era esperado.

    Exemplos

    Exemplo #1 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";
    ?>

    O exemplo acima produzirá:

    1 tuples are affected.

    Veja Também

    • pg_query() - Execute a query
    • pg_query_params() - Submits a command to the server and waits for the result, with the ability to pass parameters separately from the SQL command text
    • pg_execute() - Sends a request to execute a prepared statement with given parameters, and waits for the result
    • pg_num_rows() - Returns the number of rows in a result
    To Top