Retourne le nom d'une colonne dans un résultat MySQL

# mysql_field_name

(PHP 4, PHP 5)

mysql_field_name — Retourne le nom d'une colonne dans un résultat MySQL

Avertissement

Cette extension était obsolète en PHP 5.5.0, et a été supprimée en PHP 7.0.0. À la place, vous pouvez utiliser l'extension MySQLi ou l'extension PDO_MySQL. Voir aussi MySQL : choisir une API du guide. Alternatives à cette fonction :

- mysqli_fetch_field_direct() [name] ou [orgname]
- PDOStatement::getColumnMeta() [name]

### Description

function mysql_field_name(resource `$result`, int `$field_offset`): string|false

mysql_field_name() retourne le nom du champ de l'index spécifié.

### Liste de paramètres

`result`
  La resource 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. `field_offset` commence à `0`. Si `field_offset` n'existe pas, une alerte de niveau `E_WARNING` sera générée.

### Valeurs de retour

Le nom du champ de l'index spécifié en cas de succès ou `false` si une erreur survient.

### Exemples

Exemple #1 Exemple avec mysql_field_name()

    <?php
    /* Supposons que la table utilisée contienne trois champs :
     *   user_id
     *   username
     *   password.
     */
    $link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
    if (!$link) {
       die('Impossible de se connecter au serveur MySQL : ' . mysql_error());
    }
    $dbname = 'mydb';
    $db_selected = mysql_select_db($dbname, $link);
    if (!$db_selected) {
       die("Impossible de se connecter à la base $dbname: " . mysql_error());
    }
    $res = mysql_query('select * from users', $link);

    echo mysql_field_name($res, 0) . "\n";
    echo mysql_field_name($res, 2);
    ?>

L'exemple ci-dessus va afficher :

    user_id
    password

### Notes

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

> Note: Pour des raisons de compatibilité ascendante, l'alias obsolète suivant peut être utilisé : mysql_fieldname()

### Voir aussi

- mysql_field_type() - Retourne le type d'une colonne MySQL spécifique
- mysql_field_len() - Retourne la taille d'un champ de résultat MySQL

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open