pg_affected_rows

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

    pg_affected_rows — Retourne le nombre de lignes affectées

    Description

    pg_affected_rows(PgSql\Result$result): int

    pg_affected_rows() retourne le nombre de lignes affectées par les requêtes de type INSERT, UPDATE et DELETE.

    Depuis PostgreSQL 9.0 et suivants, le serveur retourne le nombre de lignes sélectionnées. Pour les versions antérieures, PostgreSQL retourne 0 pour les SELECT.

    Note:

    Auparavant, cette fonction s'appelait pg_cmdtuples().

    Liste de paramètres

    result

    Une instance PgSql\Result, retourné par pg_query(), pg_query_params(), ou pg_execute() (entre autres).

    Valeurs de retour

    Le nombre de lignes affectées par la requête. S'il n'y a pas de tuple affecté, la fonction retournera 0.

    Historique

    VersionDescription
    8.1.0 Le paramètre result attend désormais une instance de PgSql\Result ; auparavant, une ressource était attendu.

    Exemples

    Exemple #1 Exemple avec pg_affected_rows()

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

    $cmdtuples = pg_affected_rows($result);

    echo     $cmdtuples . " lignes ont été affectées.\n";
    ?>

    L'exemple ci-dessus va afficher :

    1 lignes ont été affectées.

    Voir aussi

    • pg_query() - Exécute une requête PostgreSQL
    • pg_query_params() - Envoie une commande au serveur et attend le résultat, avec les capacités de passer des paramètres séparément de la commande texte SQL
    • pg_execute() - Exécute une requête préparée PostGreSQL
    • pg_num_rows() - Retourne le nombre de lignes PostgreSQL
    To Top