(PHP 5)
mysqli_fetch_fields, result->fetch_fields() — Retourne un tableau d'objets représentant les champs dans le résultat
Style procédural
array mysqli_fetch_fields ( mysqli_result $result )Style orienté objet (méthode)
class mysqli_result {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.
Style procédural uniquement : Un identifiant de jeu de résultats retourné par la fonction mysqli_query() , mysqli_store_result() ou mysqli_use_result() .
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.
Tableau 186. 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) |
Exemple 1649. 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
();
?>
Exemple 1650. 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
| mysqli_num_fields() |
| mysqli_fetch_field_direct() |
| mysqli_fetch_field() |