mysqli_fetch_fields
(PHP 5)
mysqli_fetch_fields
(no version information, 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
mixed
mysqli_fetch_fields ( mysqli_result result )
Style orienté objet (méthode)
class
mysqli_result {
mixed
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.
Valeurs de retour
Retourne un tableau d'objets qui contient les données métas d'un champ ou FALSE
si aucune donnée méta 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 à 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 champ, représentée par une chaîne de caractères |
| max_length | La longueur maximale du champ pour le jeu de résultats |
| flags | Un entier représentant le bit-flags pour ce champ |
| type | Le type de données utilisées pour ce champ |
| decimals | Le 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 données métas pour toutes les colonnes */
$finfo = $result->fetch_fields();
for ($i=0; $i < count($finfo); $i++) {
printf("Nom : %s\n", $finfo[$i]->name);
printf("Table : %s\n", $finfo[$i]->table);
printf("Longueur Max. : %d\n", $finfo[$i]->max_length);
printf("Flags : %d\n", $finfo[$i]->flags);
printf("Type : %d\n\n", $finfo[$i]->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 données métas pour toutes les colonnes */
$finfo = mysqli_fetch_fields($result);
for ($i=0; $i < count($finfo); $i++) {
printf("Nom : %s\n", $finfo[$i]->name);
printf("Table : %s\n", $finfo[$i]->table);
printf("Longueur Max. : %d\n", $finfo[$i]->max_length);
printf("Flags : %d\n", $finfo[$i]->flags);
printf("Type : %d\n\n", $finfo[$i]->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 |