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 -1 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
Example#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