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

    VersionDescription
    8.3.0row est désormais nullable.
    8.1.0 Le paramètre result attend désormais une instance de PgSql\Result ; auparavant, une ressource é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

    To Top