Obtém o nome do campo especificado em um resultado

# mysql_field_name

(PHP 4, PHP 5)

mysql_field_name — Obtém o nome do campo especificado em um resultado

Aviso

Esta extensão foi descontinuada a partir do PHP 5.5.0 e foi removida no PHP 7.0.0. Em vez disso, as extensões MySQLi ou PDO_MySQL devem ser usadas. Veja também o guia MySQL: escolhendo uma API. Alternativas a esta função incluem:

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

### Descrição

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

mysql_field_name() retorna o nome do campo do índice especificado.

### Parâmetros

`result`
  O resource do resultado que está sendo avaliado. Este resultado vem de uma chamada a mysql_query().
`field_offset`
  O deslocamento numérico do campo. `field_offset` começa em `0`. Se `field_offset` não existir, um erro de nível `E_WARNING` também será emitido.

### Valor Retornado

O nome do campo do índice especificado emj caso de sucesso ou `false` em caso de falha.

### Exemplos

Exemplo #1 Exemplo mysql_field_name()

    <?php
    /* A tabela users consiste em três campos:
     *   user_id
     *   username
     *   password.
     */
    $link = mysql_connect('localhost', 'mysql_user', 'mysql_password');
    if (!$link) {
        die('Não foi possível conectar ao servidor MySQL: ' . mysql_error());
    }
    $dbname = 'mydb';
    $db_selected = mysql_select_db($dbname, $link);
    if (!$db_selected) {
        die("Não foi possível selecionar $dbname: " . mysql_error());
    }
    $res = mysql_query('select * from users', $link);

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

O exemplo acima produzirá:

    user_id
    password

### Notas

> Nota: Os nomes de campos retornados por esta função diferenciam maiúsculas e minúsculas.

> Nota: Para compatibilidade com versões anteriores, o seguinte apelido descontinuado pode ser usado: mysql_fieldname()

### Veja Também

- mysql_field_type() - Obtém o tipo do campo especificado em um resultado
- mysql_field_len() - Retorna o tamanho do campo especificado

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