Manuel PHP
Précédent |  | Suivant

# mysqli_fetch_field

(PHP 5)

mysqli_fetch_field

(no version information, might be only in CVS)

result->fetch_field -- Retourne le prochain champ dans le jeu de résultats

## Description

Style procédural

mixed mysqli_fetch_field ( object result)

Style orienté objet (méthode)

class result {
mixed fetch_field ( void )
}

mysqli_fetch_field() est utilisée pour retourner les attributs de la prochaine colonne dans le jeu de résultats représenté par le paramètre result en tant qu'objet. Appelez cette fonction de façon répétitive pour récupérer les informations de toutes les colonnes. Lors de son exécution, cette fonction retournera un objet contenant les attributs de la colonne courante ou `FALSE` s'il n'y a plus de colonnes dans le jeu de résultats.

## Valeurs de retour

Retourne un objet qui contient les informations d'un champ ou `FALSE` si aucune information n'est disponible pour ce champ.

Tableau 1. Propriétés de l'objet

Propriété | Description
--- | ---
name | Le nom de la colonne
orgname | Le nom original de la colonne si un alias a été spécifié
table | Le nom de la table auquel ce champ appartient (s'il n'a pas été calculé)
orgtable | Le nom original de la table si un alias a été spécifié
def | La valeur par défaut du champ, représenté par une chaîne de caractères
max_length | La longueur maximale du champ pour le jeux de résultats
flags | Un entier représentant le bit-flags pour ce champ
type | Le type de données utilisé pour ce champ
decimals | Le nombre de décimals utilisé (pour les champs de type entier)

## Voir aussi

mysqli_num_fields(), mysqli_fetch_field_direct(), mysqli_fetch_fields() et mysqli_field_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 Name, SurfaceArea from Country ORDER BY Code LIMIT 5";
if ($result = $mysqli->query($query)) {
/* Récupération des informations pour toutes les colonnes */
while ($finfo = $result->fetch_field()) {
printf("Nom : %s\n", $finfo->name);
printf("Table : %s\n", $finfo->table);
printf("Longueur Max. : %d\n", $finfo->max_length);
printf("Flags : %d\n", $finfo->flags);
printf("Type : %d\n\n", $finfo->type);
}
$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 Name, SurfaceArea from Country ORDER BY Code LIMIT 5";
if ($result = mysqli_query($link, $query)) {
/* Récupération des informations pour toutes les colonnes */
while ($finfo = mysqli_fetch_field($result)) {
printf("Nom : %s\n", $finfo->name);
printf("Table : %s\n", $finfo->table);
printf("Longueur Max. : %d\n", $finfo->max_length);
printf("Flags : %d\n", $finfo->flags);
printf("Type : %d\n\n", $finfo->type);
}
mysqli_free_result($result);
}
/* Fermeture de la connexion */
mysqli_close($link);
?>`

L'exemple ci-dessus va afficher :

    Nom :     Name
    Table :    Country
    Longueur Max. : 11
    Flags :    1
    Type :     254

    Nom :     SurfaceArea
    Table :    Country
    Longueur Max. : 10
    Flags :    32769
    Type :     4

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