Manuel PHP

mysql_fetch_field

(PHP 4, PHP 5, PECL mysql:1.0)

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 ] )

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

Example#1 Exemple avec mysql_fetch_field()

  1. <?php
  2. $conn = mysql_connect('localhost', 'mysql_user', 'mysql_password');  
  3. if (!$conn) {  
  4. die('Impossible de se connecter : ' . mysql_error());  
  5. }  
  6. mysql_select_db('database');  
  7. $result = mysql_query('select * from table');  
  8. if (!$result) {  
  9. die('Échec de la requête : ' . mysql_error());  
  10. }  
  11. /* Lecture des méta données de la colonne */  
  12. $i = 0;  
  13. while ($i < mysql_num_fields($result)) {  
  14. echo "Détails sur la colonne$i:<br />\n";  
  15. $meta = mysql_fetch_field($result, $i);  
  16. if (!$meta) { 
  17.    echo "Aucun détail disponible<br />\n";  
  18. }  
  19. echo "<pre>
  20.    blob:      $meta->blob 
  21.    max_length:$meta->max_length 
  22.    multiple_key:$meta->multiple_key 
  23.    name:      $meta->name 
  24.    not_null:   $meta->not_null 
  25.    numeric:   $meta->numeric 
  26.    primary_key:$meta->primary_key 
  27.    table:      $meta->table 
  28.    type:      $meta->type 
  29.    default:   $meta->def 
  30.    unique_key:$meta->unique_key 
  31.    unsigned:   $meta->unsigned 
  32.    zerofill:   $meta->zerofill 
  33. </pre>";  
  34. $i++;  
  35. }  
  36. mysql_free_result($result);  
  37. ?> 

Notes

Note: Les noms des champs retournés par cette fonction sont sensibles à la casse.

Voir aussi


Remonter Remonter
L'éditeur javascript - CSS - Gentoo - Tutoriaux PHP - Tutoriels PHP - Breizh Blog