(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
pg_field_prtlen — Retourne la taille imprimée
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().
resultUne instance PgSql\Result, retourné par pg_query(), pg_query_params(), ou pg_execute() (entre autres).
rowNumé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.
Le nombre de caractères imprimés.
| Version | Description |
|---|---|
| 8.1.0 |
Le paramètre result attend désormais une instance de
PgSql\Result ; auparavant, une ressource était attendu.
|
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