(PHP 5)
mysqli_fetch_field, result->fetch_field() — Retourne le prochain champs dans le jeu de résultats
Style procédural
object mysqli_fetch_field ( mysqli_result $result )Style orienté objet (méthode)
class mysqli_result {Retourne 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.
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 objet qui contient les informations d'un champ ou FALSE si aucune information n'est disponible pour ce champs.
Tableau 185. 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 champs 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 1647. 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 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 1648. 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 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
| mysqli_num_fields() |
| mysqli_fetch_field_direct() |
| mysqli_fetch_fields() |
| mysqli_field_seek() |