dba_fetch

(PHP 4, PHP 5, PHP 7, PHP 8)

dba_fetch — Liest die Daten zu einem angegebenen Schlüssel aus

Beschreibung

dba_fetch(string|array $key, Dba\Connection $dba, int $skip = 0): string|false

Seit PHP 8.3.0 ist die überladene Signatur veraltet:

dba_fetch(string|array $key, int $skip, resource $dba): string

dba_fetch() liest die durch key festgelegten Daten aus der durch dba spezifizierten Datenbank aus.

Parameter-Liste

key
Der Schlüssel, durch den die Daten bestimmt sind.

Hinweis: Wenn mit ini-Dateien gearbeitet wird, akzeptiert diese Funktion Arrays als Schlüssel, wobei der Index 0 die Gruppe ist und der Index 1 der Name des Wertes. Siehe dba_key_split().

dba
Eine von dba_open() oder dba_popen() zurückgegebene Instanz von Dba\Connection.
skip
Die Anzahl der Schlüssel-Wert-Paare, die bei cdb-Datenbanken ignoriert werden sollen. Dieser Wert wird bei allen anderen Datenbanken, die keine Unterstützung für mehrere Schlüssel mit demselben Namen bieten, ignoriert.

Rückgabewerte

Falls das Schlüssel/Wert-Paar gefunden wird, wird die zugehörige Zeichenkette zurückgegeben, andernfalls false.

Changelog

Version Beschreibung
8.4.0 Der Parameter dba erwartet nun eine Instanz von Dba\Connection; zuvor wurde eine gültige dba-Ressource erwartet.
8.3.0 Der Aufruf von dba_fetch() mit dba als drittes Argument ist nun veraltet.
8.2.0 Das optionale Skip-Argument von dba_fetch() steht nun an letzter Stelle, was der Semantik benutzerdefinierter Funktionen in PHP entspricht. Die zuvor verwendete überladene Signatur ist nach wie vor zulässig, aber es wird empfohlen, sie nicht zu verwenden.

Siehe auch

  • dba_exists() - Überprüft, ob ein angegebener Schlüssel existiert
  • dba_delete() - Löscht den zum angegebenen Schlüssel gehörigen DBA-Eintrag
  • dba_insert() - Fügt einen Eintrag ein
  • dba_replace() - Ersetzt einen Eintrag oder fügt ihn ein
  • dba_key_split() - Zerlegt einen Schlüssel in Zeichenketten-Darstellung in eine Array-Darstellung