mysql_list_fields

(PHP 4, PHP 5)

mysql_list_fieldsListe les champs d'une table MySQL

Description

resource mysql_list_fields ( string $database_name , string $table_name [, resource $link_identifier ] )

Liste les champs de la table MySQL sp�cifi�e.

La fonction mysql_list_fields() est obsol�te. Il est pr�f�rable d'utiliser la fonction mysql_query() avec comme requ�te SHOW COLUMNS FROM table [LIKE 'name'] � la place.

Liste de param�tres

database_name

Le nom de la base de donn�es qui va �tre interrog�e.

table_name

Le nom de la table qui va �tre interrog�e.

link_identifier

La connexion MySQL. S'il n'est pas sp�cifi�, la derni�re connexion ouverte avec la fonction mysql_connect() sera utilis�e. Si une telle connexion n'est pas trouv�e, la fonction tentera d'ouvrir une connexion, comme si la fonction mysql_connect() avait �t� appel�e sans argument. Si aucune connexion n'est trouv�e ou �tablie, une alerte E_WARNING est g�n�r�e.

Valeurs de retour

Une ressource de pointeurs de r�sultats en cas de succ�s, ou FALSE si une erreur survint.

Le r�sultat retourn� peut �tre utilis� avec les fonction mysql_field_flags(), mysql_field_len(), mysql_field_name() et mysql_field_type().

Exemples

Exemple #1 Exemple d'alternative � mysql_list_fields()

<?php
$result 
mysql_query("SHOW COLUMNS FROM sometable");
if (!
$result) {
   echo 
'Impossible d\'ex�cuter la requ�te : ' mysql_error();
   exit;
}
if (
mysql_num_rows($result) > 0) {
   while (
$row mysql_fetch_assoc($result)) {
      
print_r($row);
   }
}
?>

L'exemple ci-dessus va afficher quelque chose de similaire � :

Array
(
   [Field] => id
   [Type] => int(7)
   [Null] =>  
   [Key] => PRI
   [Default] =>
   [Extra] => auto_increment
)
Array
(
   [Field] => email
   [Type] => varchar(100)
   [Null] =>
   [Key] =>
   [Default] =>
   [Extra] =>
)

Notes

Note: Pour des raisons de compatibilit� ascendante, l'alias obsol�te suivant peut �tre utilis� : mysql_listfields()

Voir aussi