Manuel PHP
Précédent |  | Suivant

# mysql_list_fields

(PHP 3, PHP 4 , PHP 5)

mysql_list_fields -- Liste les champs du résultat MySQL

## Description

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

mysql_list_fields() recherche les informations relatives à la table `table_name` sur la connexion MySQL courante, ou bien sûr la connexion spécifiée par `link_identifier`. Les arguments sont la base de données `database_name` et le nom de la table `table_name`. Un pointeur de résultat est retourné et pourra être passé à mysql_field_flags(), mysql_field_len(), mysql_field_name() et mysql_field_type().

Un identifiant de résultat est un entier positif. La fonction retourne -1 si une erreur survient. Une chaîne décrivant le problème rencontré sera placée dans la variable `$phperrmsg` et, à moins que la fonction n'ait été appelée sous la forme `@mysql()`, cette erreur sera aussi affichée.

Exemple 1. Exemple avec mysql_list_fields()

`<?php $link = mysql_connect('localhost', 'mysql_user', 'mysql_password'); $fields = mysql_list_fields("database1", "table1", $link); $columns = mysql_num_fields($fields); for ($i = 0; $i < $columns; $i++) { echo mysql_field_name($fields, $i) . "\n"; } ?>`

Le script ci-dessus va afficher :

    field1
    field2
    field3
    ...

Pour des raisons de compatibilité ascendante, mysql_listfields() est encore disponible.

> Note : La fonction mysql_list_fields() est obsolète. Il est recommandé d'utiliser mysql_query() pour émettre une requête SQL `SHOW COLUMNS FROM table [LIKE 'name']`.

Précédent | Sommaire | Suivant
mysql_list_dbs | Niveau supérieur | mysql_list_processes