# pg_field_prtlen

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

pg_field_prtlen — Retourne la taille imprimée

### Description

pg_field_prtlen(PgSql\Result `$result`, string|false|null `$row` , mixed `$field_name_or_number`): int
pg_field_prtlen(PgSql\Result `$result`, mixed `$field_name_or_number`): int

pg_field_prtlen() retourne la taille imprimée (nombre de caractères) d'une valeur donnée dans un résultat PostgreSQL. La numérotation des lignes commence à 0. pg_field_prtlen() retourne `false` en cas d'erreur.

Le paramètre `field_name_or_number` peut être passé soit en tant qu'entier, soit en tant que chaîne de caractères. S'il est passé en tant qu'entier, PHP l'identifie comme le numéro d'un champ, sinon, comme le nom d'un champ.

Voir l'exemple donné à la page de la documentation de la fonction pg_field_name().

> Note:

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

### Liste de paramètres

`result`

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

`row`

  Numéro de la ligne dans le résultat. Les lignes sont numérotées à partir de 0 en montant. Si ce paramètre n'est pas fourni, la ligne en cours est récupérée.

### Valeurs de retour

Le nombre de caractères imprimés.

### Historique

Version | Description
--- | ---
8.3.0 | `row` est désormais nullable.
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 à propos des champs

`<?php
$dbconn = pg_connect("dbname=editeur") 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 "nom champ : $fieldname\n";
echo "taille affichage : " . pg_field_prtlen($res, $fieldname) . " caractères\n";
echo "taille enregistrement : " . pg_field_size($res, $j) . " octets\n";
echo "type champ : " . pg_field_type($res, $j) . " \n\n";
}
?>`

L'exemple ci-dessus va afficher :

    colonne 0
    nom champ : auteur
    taille affichage : 6 caractères
    taille enregistrement : -1 octets
    type champ : varchar

    colonne 1
    nom champ : annee
    taille affichage : 4 caractères
    taille enregistrement : 2 octets
    type champ : int2

    colonne 2
    nom champ : titre
    taille affichage : 24 caractères
    taille enregistrement : -1 octets
    type champ : varchar

### Voir aussi

- pg_field_size() - Retourne la taille interne de stockage d'un champ donné