pg_field_prtlen
(PHP 4 >= 4.2.0, PHP 5)
pg_field_prtlen — Retourne la taille imprimée
Description
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
-
Ressource de résultat de requête PostgreSQL, retournée 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 ou FALSE
en cas d'erreur.
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