Manuel PHP
Précédent |  | Suivant

# mysqli_fetch_assoc

(PHP 5)

mysqli_fetch_assoc

(no version information, might be only in CVS)

mysqli->fetch_assoc -- Récupère une ligne de résultat sous forme de tableau associatif

## Description

Style procédural

array mysqli_fetch_assoc ( mysqli_result result )

Style orienté objet (méthode)

class mysqli_result {
array fetch_assoc ( void )
}

Retourne un tableau associatif qui correspond à la ligne récupérée ou `FALSE` s'il n'y a plus de ligne.

La fonction mysqli_fetch_assoc() est utilisée pour retourner un tableau associatif représentant la prochaine ligne dans le jeu de résultats représenté par le paramètre result, où chaque clef du tableau représente le nom d'une colonne du résultat.

Si deux ou plus colonnes dans le jeu de résultat ont le même nom, le tableau associatif retrourné par la fonction mysqli_fetch_assoc() ne contiendra que la valeur de la dernière colonne de ce nom. Si vous devez travailler avec des jeux de résultats ayant cette particularité, la fonction mysqli_fetch_row() qui retourne un tableau indexé doit être utilisée à la place.

> Note : Les noms des champs retournés par cette fonction sont sensibles à la casse.

> Note : Cette fonction définie les champs NULL à la valeur PHP `NULL`.

## Valeurs de retour

Retourne un tableau qui correspond à la ligne sélectionnée ou `NULL` s'il n'y a plus de ligne dans le jeu de résultats.

## Voir aussi

mysqli_fetch_array(), mysqli_fetch_row(), mysqli_fetch_object(), mysqli_query() et mysqli_data_seek().

## Exemples

Exemple 1. Style orienté objet
`<?php $mysqli = new mysqli("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Echec de la connexion : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Nom, CodePays FROM Ville ORDER by ID DESC LIMIT 50,5"; if ($result = $mysqli->query($query)) { /* Tableau associatif de la ligne sélectionnée */ while ($row = $result->fetch_assoc()) { printf ("%s (%s)\n", $row["Nom"], $row["CodePays"]); } /* Libération du jeu de résultats */ $result->close(); } /* Fermeture de la connexion */ $mysqli->close(); ?>`

Exemple 2. Style procédural
`<?php $link = mysqli_connect("localhost", "my_user", "my_password", "world"); /* Vérification de la connexion */ if (mysqli_connect_errno()) { printf("Echec de la connexion : %s\n", mysqli_connect_error()); exit(); } $query = "SELECT Nom, CodePays FROM Ville ORDER by ID DESC LIMIT 50,5"; if ($result = mysqli_query($link, $query)) { /* Tableau associatif de la ligne sélectionnée */ while ($row = mysqli_fetch_assoc($result)) { printf ("%s (%s)\n", $row["Nom"], $row["CodePays"]); } /* Libération du jeu de résultats */ mysqli_free_result($result); } /* Fermeture de la connexion */ mysqli_close($link); ?>`

L'exemple ci-dessus va afficher :

    Rennes (FRA)
    Bordeaux (FRA)
    Rouen (FRA)
    Paris (FRA)
    Saint-Savin (FRA)

Précédent | Sommaire | Suivant
mysqli_fetch_array | Niveau supérieur | mysqli_fetch_field_direct