mysqli_fetch_fields

result->fetch_fields()

(No version information available, might be only in CVS)

result->fetch_fields() — Retourne un tableau d'objets représentant les champs dans le résultat

Description

Style procédural

array mysqli_fetch_fields ( mysqli_result $result )

Style orienté objet (méthode)

mysqli_result

array fetch_fields ( void )

Cette fonction fonctionne comme mysqli_fetch_field() à la différence que, au lieu de retourner un objet à la fois pour chaque champ, les colonnes sont retournées en tant que tableau d'objets.

Liste de paramètres

result: Style procédural uniquement : Un identifiant de jeu de résultats retourné par la fonction mysqli_query(), mysqli_store_result() ou mysqli_use_result().

Valeurs de retour

Retourne un tableau d'objets qui contient les metadonnées d'un champ ou FALSE si aucune metadonnée n'est disponible pour ce champ.

**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 à laquelle 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 champs, représentée par une chaîne de caractères
max_length	La longueur maximale du champs pour le jeu de résultats
length	La largeur du champs, comme spécifiée dans la définition de table
charsetnr	Le numéro du jeu de caractères pour ce champs
flags	Un entier représentant le bit-flags pour ce champs
type	Le type de données utilisées pour ce champs
decimals	Le nombre de décimales utilisées (pour les champs de type entier)

Exemples

Example#1 Style orienté objet


<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* Vérification de la connexion */
if (mysqli_connect_errno()) {
    printf("Échec 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 données métas pour toutes les colonnes */
    $finfo = $result->fetch_fields();

    foreach ($finfo as $val) {
        printf("Nom :     %s\n", $val->name);
        printf("Table :    %s\n", $val->table);
        printf("Longueur Max. : %d\n", $val->max_length);
        printf("Flags :    %d\n", $val->flags);
        printf("Type :     %d\n\n", $val->type);
    }
    $result->close();
}

/* Fermeture de la connexion */
$mysqli->close();
?>

Example#2 Style procédural


<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");

/* Vérification de la connexion */
if (mysqli_connect_errno()) {
    printf("Échec 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 données métas pour toutes les colonnes */
    $finfo = mysqli_fetch_fields($result);

    foreach ($finfo as $val) {
        printf("Nom :     %s\n", $val->name);
        printf("Table :    %s\n", $val->table);
        printf("Longueur Max. : %d\n", $val->max_length);
        printf("Flags :    %d\n", $val->flags);
        printf("Type :     %d\n\n", $val->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