ArrayAccess::offsetExists
(PHP 5, PHP 7, PHP 8)
ArrayAccess::offsetExists — Prüft, ob ein Offset-Punkt existiert
Beschreibung
Prüft, ob ein Offset-Punkt existiert oder nicht.
Diese Methode wird aufgerufen, wenn die Funktionen isset() oder empty() auf Objekte angewendet werden, die ArrayAccess implementieren.
Hinweis:
Wenn empty() verwendet wird, wird die Funktion ArrayAccess::offsetGet() nur dann aufgerufen und untersucht, ob noch kein Wert zugewiesen wurde, wenn ArrayAccess::offsetExists()
true
zurückgibt.
Parameter-Liste
-
offset
-
Der zu untersuchende Offset-Punkt.
Rückgabewerte
Gibt bei Erfolg true
zurück. Bei einem Fehler wird false
zurückgegeben.
Hinweis:
Wenn der Rückgabewert kein Boolean ist, wird er in bool umgewandelt.
Beispiele
Beispiel #1 ArrayAccess::offsetExists()-Beispiel
<?php
class obj implements ArrayAccess {
public function offsetSet($offset, $wert): void {
var_dump(__METHOD__);
}
public function offsetExists($var): bool {
var_dump(__METHOD__);
if ($var == "foobar") {
return true;
}
return false;
}
public function offsetUnset($var): void {
var_dump(__METHOD__);
}
#[\ReturnTypeWillChange]
public function offsetGet($var) {
var_dump(__METHOD__);
return "Wert";
}
}
$obj = new obj;
echo "Ausführung obj::offsetExists()\n";
var_dump(isset($obj["foobar"]));
echo "\nAusführung obj::offsetExists() und obj::offsetGet()\n";
var_dump(empty($obj["foobar"]));
echo "\nAusführung obj::offsetExists(), "
."obj:offsetGet() wird *nicht* ausgeführt, "
."wenn nichts zurückgegeben werden kann\n";
var_dump(empty($obj["foobaz"]));
?>
Das oben gezeigte Beispiel erzeugt eine ähnliche Ausgabe wie:
Ausführung obj::offsetExists() string(17) "obj::offsetExists" bool(true) Ausführung obj::offsetExists() und obj::offsetGet() string(17) "obj::offsetExists" string(14) "obj::offsetGet" bool(false) Ausführung obj::offsetExists(), obj:offsetGet() wird *nicht* ausgeführt, wenn nichts zurückgegeben werden kann string(17) "obj::offsetExists" bool(true)