pg_field_prtlen

(PHP 4 >= 4.2.0, PHP 5)

pg_field_prtlen — Retourne la taille imprimée

Description

int pg_field_prtlen ( resource $result, int $row_number, mixed $field_name_or_number )
int pg_field_prtlen ( resource $result, mixed $field_name_or_number )

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

Exemple 2096. 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()