(PHP 5)
mysqli_fetch_field_direct, result->fetch_field_direct() — Récupère les metadonnées d'un champ unique
Style procédural
object mysqli_fetch_field_direct ( mysqli_result $result, int $fieldnr )Style orienté objet (méthode)
class mysqli_result {Retourne un objet qui contient les metadonnées d'un champ depuis le jeu de résultats spécifié.
Style procédural uniquement : Un identifiant de jeu de résultats retourné par la fonction mysqli_query() , mysqli_store_result() ou mysqli_use_result() .
Le numéro du champs. Cette valeur doit être dans l'intervalle 0 à nombre de champs - 1 .
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 184. Attributs de l'objet
| Attribut | 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 1645. 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 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 1646. 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 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
| mysqli_num_fields() |
| mysqli_fetch_field() |
| mysqli_fetch_fields() |