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

object mysql_fetch_field ( resource $result [, int $field_offset= 0 ] )

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.

Voir aussi