pg_field_prtlen

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

pg_field_prtlenLiefert die Länge des Feldes

Beschreibung

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() 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

VersionBeschreibung
8.3.0row 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
To Top