Liefert die Länge des Feldes

# pg_field_prtlen

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pg_field_prtlen — Liefert die Länge des Feldes

### Beschreibung

function pg_field_prtlen(PgSql\Result `$result`, string|false|null `$row`, mixed `$field_name_or_number`): int
function pg_field_prtlen(PgSql\Result `$result`, mixed `$field_name_or_number`): int

pg_field_prtlen() gibt die aktuelle Länge (Anzahl der Zeichen) eines bestimmten Wertes in einem PostgreSQL-`result` zurück. Die Feldnummerierung beginnt bei 0. Die Funktion gibt bei einem Fehler `false` zurück.

`field_name_or_number` kann als int oder als string übergeben werden. Ein int wird von PHP als Feldnummer interpretiert, ein string als Feldname.

Sehen Sie sich dazu das Beispiel bei pg_field_name() an.

> Hinweis:

> Diese Funktion ersetzt die Funktion pg_fieldprtlen().

### Parameter-Liste

`result`

  Eine PgSql\Result-Instanz, die von pg_query(), pg_query_params() oder pg_execute() (unter anderen) zurückgegeben wurde.

`row`

  Die Nummer der Zeile im Abfrageergebnis. Die Nummerierung beginnt bei 0. Fehlt dieser Parameter, so wird jeweils die nächste Zeile geholt.

### Rückgabewerte

Die Anzahl der Zeichen in dem Feld.

### Changelog

Version | Beschreibung
--- | ---
8.3.0 | `row` ist nun nullable (akzeptiert den `null`-Wert).
8.1.0 | Der Parameter `result` erwartet nun eine PgSql\Result-Instanz; vorher wurde eine Ressource erwartet.

### Beispiele

Beispiel #1 Informationen über Spalten ermitteln

    <?php
      $dbconn = pg_connect("dbname=publisher") or die("Verbindungsaufbau fehlgeschlagen");

      $res = pg_query($dbconn, "select * from authors where author = 'Orwell'");
      $i = pg_num_fields($res);
      for ($j = 0; $j < $i; $j++) {
          echo "Spalte $j\n";
          $fieldname = pg_field_name($res, $j);
          echo "Spaltenname: $fieldname\n";
          echo "Anzahl Druckzeichen: " . pg_field_prtlen($res, $fieldname) . " characters\n";
          echo "Anzahl Bytes im speicher: " . pg_field_size($res, $j) . " bytes\n";
          echo "Spaltentyp: " . pg_field_type($res, $j) . " \n\n";
      }
    ?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    Spalte 0
    Spaltenname: author
    Anzahl Druckzeichen: 6 characters
    Anzahl Bytes im speicher: -1 bytes
    Spaltentyp: varchar

    Spalte 1
    Spaltenname: year
    Anzahl Druckzeichen: 4 characters
    Anzahl Bytes im speicher: 2 bytes
    Spaltentyp: int2

    Spalte 2
    Spaltenname: title
    Anzahl Druckzeichen: 24 characters
    Anzahl Bytes im speicher: -1 bytes
    Spaltentyp: varchar

### Siehe auch

- pg_field_size() - Liefert die interne Größe des belegten Speichers für ein Feld

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open