mysqli_fetch_field_direct

(PHP 5)

mysqli_fetch_field_direct

(no version information, might be only in CVS)

result->fetch_field_direct --  Récupère les données métas d'un champ unique

Description

Style procédural

mixed mysqli_fetch_field_direct ( object result, int fieldnr)

Style orienté objet (méthode)

class result {

mixed fetch_field_direct ( int fieldnr)

}

mysqli_fetch_field_direct() retourne un objet qui contient les données métas d'un champ depuis le jeux de résultats result. Les valeurs de fieldnr doivent être dans l'intervalle 0 à nombre de champs - 1.

Valeurs de retour

Retourne un objet qui contient les données métas d'un champ ou FALSE si aucune donnée méta n'est spécifiée pour le champ fieldnr.

Tableau 1. Attributs de l'objet

AttributDescription
nameLe nom de la colonne
orgnameLe nom original de la colonne si un alias a été spécifié
tableLe nom de la table auquel 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é par une chaîne de caractères
max_lengthLa longueur maximale du champ pour le jeux de résultats
flagsUn entier représentant le bit-flags pour ce champ
typeLe type de données utilisé pour ce champ
decimalsLe nombre de décimals utilisé (pour les champs de type entier)

Voir aussi

mysqli_num_fields(), mysqli_fetch_field() et mysqli_fetch_fields().

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 Name LIMIT 5";

if (
$result = $mysqli->query($query)) {

    
/* Récupération des données métas pour la colonne 'SurfaceArea' */
    
$finfo = $result->fetch_field_direct(1);

    
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", $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 Name LIMIT 5";

if (
$result = mysqli_query($link, $query)) {

    
/* Récupération des données métas pour la colonne 'SurfaceArea' */
    
$finfo = mysqli_fetch_field_direct($result, 1);

    
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", $finfo->type);

    
mysqli_free_result($result);
}

/* Fermeture de la connexion */
mysqli_close($link);
?>

L'exemple ci-dessus va afficher :

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