# pg_field_name

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_field_name — Retourne le nom d'un champ PostgreSQL

### Description

pg_field_name(PgSql\Result `$result`, int `$field`): string

pg_field_name() retourne le nom du champ qui occupe la colonne numéro `field` dans le résultat `result`. La numérotation des champs commence à 0.

> Note:

> Auparavant, cette fonction s'appelait pg_fieldname().

### Liste de paramètres

`result`

  Une instance PgSql\Result, retourné par pg_query(), pg_query_params(), ou pg_execute() (entre autres).

`field`

  Numéro du champ, commençant à 0.

### Valeurs de retour

Le nom du champ.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `result` attend désormais une instance de PgSql\Result ; auparavant, une resource était attendu.

### Exemples

Exemple #1 Récupération d'informations des champs

`<?php
$dbconn = pg_connect("dbname=publisher") or die("Connexion impossible");
$res = pg_query($dbconn, "select * from auteurs where auteur = 'Orwell'");
$i = pg_num_fields($res);
for ($j = 0; $j < $i; $j++) {
echo "colonne $j\n";
$fieldname = pg_field_name($res, $j);
echo "Champ : $fieldname\n";
echo "Taille affichée : ".pg_field_prtlen($res, $fieldname)." caractères\n";
echo "Taille de stockage : ".pg_field_size($res, $j)." octets\n";
echo "Type de champ : ".pg_field_type($res, $j)." \n\n";
}
?>`

L'exemple ci-dessus va afficher :

    colonne 0
    Champ : auteur
    Taille affichée : 6 caractères
    Taille de stockage : -1 octets
    Type de champ : varchar

    colonne 1
    Champ : annee
    Taille affichée : 4 caractère
    Taille de stockage : 2 octets
    Type de champ : int2

    colonne 2
    Champ : titre
    Taille affichée : 24 caractères
    Taille de stockage : -1 octets
    Type de champ : varchar

### Voir aussi

- pg_field_num() - Retourne le numéro d'une colonne