PHP 8.4.2 Released!

    mysqli_result::fetch_row

    mysqli_fetch_row

    (PHP 5, PHP 7, PHP 8)

    mysqli_result::fetch_row -- mysqli_fetch_row — Récupère une ligne de résultat sous forme de tableau indexé

    Description

    Style orienté objet

    public mysqli_result::fetch_row(): array|null|false

    Style procédural

    mysqli_fetch_row(mysqli_result $result): array|null|false

    Récupère une ligne de données à partir du jeu de résultats représenté par result et le retourne en tant que tableau indexé, où chaque colonne est une case du tableau, celui-ci commençant à 0 (zéro). Chaque nouvel appel à mysqli_fetch_row() retournera la prochaine ligne dans le jeu de résultats, ou null s'il n'y a plus de lignes.

    Note: Cette fonction définit les champs NULL à la valeur PHP null.

    Liste de paramètres

    result

    Style procédural uniquement : Un objet mysqli_result retourné par mysqli_query(), mysqli_store_result(), mysqli_use_result(), ou mysqli_stmt_get_result().

    Valeurs de retour

    Retourne un tableau énuméré représentant la ligne récupérée, null s'il n'y a plus de lignes dans le jeu de résultats, ou false si une erreur survient.

    Exemples

    Exemple #1 Exemple mysqli_result::fetch_row()

    Style orienté objet

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, CountryCode FROM City ORDER BY ID DESC";

    $result = $mysqli->query($query);

    /* Récupère un tableau d'objets */
    while ($row = $result->fetch_row()) {
    printf("%s (%s)\n", $row[0], $row[1]);
    }

    Style procédural

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = mysqli_connect("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, CountryCode FROM City ORDER BY ID DESC";

    $result = mysqli_query($mysqli, $query);

    /* Récupère un tableau associatif */
    while ($row = mysqli_fetch_row($result)) {
    printf("%s (%s)\n", $row[0], $row[1]);
    }

    Les exemples ci-dessus vont afficher quelque chose de similaire à :

    Pueblo (USA)
Arvada (USA)
Cape Coral (USA)
Green Bay (USA)
Santa Clara (USA)

    Voir aussi

    • mysqli_fetch_array() - Récupère la ligne suivante d'un ensemble de résultats sous forme de tableau associatif, numérique ou les deux
    • mysqli_fetch_assoc() - Récupère la ligne suivante d'un ensemble de résultats sous forme de tableau associatif
    • mysqli_fetch_column() - Récupère une seule colonne de la ligne suivante d'un jeu de résultats
    • mysqli_fetch_object() - Retourne la ligne suivante d'un ensemble de résultats sous forme d'objet
    • mysqli_query() - Exécute une requête sur la base de données
    • mysqli_data_seek() - Déplace le pointeur interne de résultat

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 4 notes

    up
    20
    Stephen
    17 years ago
    It's worth noting that the MySQLi functions (and, I presume, the MySQL functions) fetch a string regardless of the MySQL data type. E.g. if you fetch a row with an integer column, the corresponding value for that column and row will still be stored as a string in the array returned by mysql_fetch_row.
    up
    4
    sainthyoga2003 at gmail dot com
    10 years ago
    Note that mysqli_fetch() is deprecated but still is in PHP function list. mysqli_fetch_row() is nowadays mysql procedural style used, but is not listed in PHP functions.
    up
    4
    evangun2001 at yahoo dot fr
    17 years ago
    Remember that fetch() and fetch_row() are two different things, and differ in the way to use them.

    - fetch() is used on a statement (like an executed prepared statement) and needs to be used in association with bind_result().

    - fetch_row() is used on a result (like the result of query()).

    As a consequence, if you want to use to use fetch_row() with an executed prepared statement, first you'll have to get the result out of this statement with mysqli_store_result() or mysqli_use_result().
    up
    -3
    maillist at pnpitalia.it
    20 years ago
    from "README.PHP4-TO-PHP5-THIN-CHANGES"

    4. Be careful when porting from ext/mysql to ext/mysqli. The following
    functions return NULL when no more data is available in the result set
    (ext/mysql's functions return FALSE).

    - mysqli_fetch_row()
    - mysqli_fetch_array()
    - mysqli_fetch_assoc()
    ＋add a note
    To Top