mysql_fetch_field
(PHP 4, PHP 5)
mysql_fetch_field — Retourne les donn�es enregistr�es dans une colonne MySQL sous forme d'objet
Description
Retourne un objet contenant les informations sur les champs. Cette fonction peut �tre utilis�e pour obtenir des informations sur les champs de la requ�te fournie result .
Liste de param�tres
- result
-
La ressource de r�sultat qui vient d'�tre �valu�e. Ce r�sultat vient de l'appel � la fonction mysql_query().
- field_offset
-
La position num�rique du champ. Si la position du champ n'est pas sp�cifi�e, le champ suivant qui n'a pas encore �t� r�cup�r� par cette fonction est alors r�cup�r�. field_offset commence � 0.
Valeurs de retour
Retourne un objet contenant les informations sur les champs. Les propri�t�s de l'objet sont les suivantes :
- "name" : nom de la colonne
- "table" : nom de la table de la colonne
- "def" : valeur par d�faut de la colonne
- "max_length" : taille maximale de la colonne
- "not_null" : 1 si la colonne ne peut pas �tre NULL
- "primary_key" : 1 si la colonne est une cl� primaire
- "unique_key" : 1 si la colonne est une cl� unique
- "multiple_key" : 1 si la colonne est une cl� non unique
- "numeric" : 1 si la colonne est num�rique
- "blob" : 1 si la colonne est BLOB
- "type" : le type de la colonne
- "unsigned" : 1 si la colonne est non sign�e
- "zerofill" : 1 si la colonne est compl�t�e par des z�ro
Exemples
Exemple #1 Exemple avec mysql_fetch_field()
<?php
$conn = mysql_connect('localhost', 'mysql_user', 'mysql_password');
if (!$conn) {
die('Impossible de se connecter : ' . mysql_error());
}
mysql_select_db('database');
$result = mysql_query('select * from table');
if (!$result) {
die('�chec de la requ�te : ' . mysql_error());
}
/* Lecture des m�ta donn�es de la colonne */
$i = 0;
while ($i < mysql_num_fields($result)) {
echo "D�tails sur la colonne $i:<br />\n";
$meta = mysql_fetch_field($result, $i);
if (!$meta) {
echo "Aucun d�tail disponible<br />\n";
}
echo "<pre>
blob: $meta->blob
max_length: $meta->max_length
multiple_key: $meta->multiple_key
name: $meta->name
not_null: $meta->not_null
numeric: $meta->numeric
primary_key: $meta->primary_key
table: $meta->table
type: $meta->type
default: $meta->def
unique_key: $meta->unique_key
unsigned: $meta->unsigned
zerofill: $meta->zerofill
</pre>";
$i++;
}
mysql_free_result($result);
?>
Notes
Note: Les noms des champs retourn�s par cette fonction sont sensibles � la casse.