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

object mysqli_fetch_field ( mysqli_result result )

Style orienté objet (méthode)

class mysqli_result {

object 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
nameLe nom de la colonne
orgnameLe nom original de la colonne si un alias a été spécifié
tableLe nom de la table à laquelle ce champ appartient (s'il n'a pas été calculé)
orgtableLe nom original de la table si un alias a été spécifié
defLa valeur par défaut du champ, représentée par une chaîne de caractères
max_lengthLa longueur maximale du champ pour le jeu de résultats
flagsUn entier représentant le bit-flags pour ce champ
typeLe type de données utilisées pour ce champ
decimalsLe nombre de décimales utilisées (pour les champs de type entier)

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

Voir aussi

mysqli_num_fields(), mysqli_fetch_field_direct(), mysqli_fetch_fields() et mysqli_field_seek().

Hosting by: Hurra Communications GmbH
Generated: 2007-01-26 18:01:52