(PHP 5, PHP 7, PHP 8)
ArrayAccess::offsetExists — Indique si une position existe dans un tableau
Indique si une position existe.
Cette méthode est exécutée lorsque la fonction isset() ou empty() est appliquée à un objet qui implémente l'interface ArrayAccess.
Note:
Lors de l'utilisation de empty(), ArrayAccess::offsetGet() est appelé et vérifie si la valeur est vide, uniquement si ArrayAccess::offsetExists() retourne
true
.
offset
Une position à vérifier.
Cette fonction retourne true
en cas de succès ou false
si une erreur survient.
Note:
La valeur retournée sera transtypée en booléen si une valeur non booléenne est retournée.
Exemple #1 Exemple avec ArrayAccess::offsetExists()
<?php
class obj implements Arrayaccess {
public function offsetSet($offset, $value): 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 "value";
}
}
$obj = new obj;
echo "Exécute obj::offsetExists()\n";
var_dump(isset($obj["foobar"]));
echo "\nExécute obj::offsetExists() et obj::offsetGet()\n";
var_dump(empty($obj["foobar"]));
echo "\nExécute obj::offsetExists(), *et non pas* obj:offsetGet() car il n'y a rien à lire\n";
var_dump(empty($obj["foobaz"]));
?>
Résultat de l'exemple ci-dessus est similaire à :
Exécute obj::offsetExists() string(17) "obj::offsetExists" bool(true) Exécute obj::offsetExists() et obj::offsetGet() string(17) "obj::offsetExists" string(14) "obj::offsetGet" bool(false) Exécute obj::offsetExists(), *et non pas* obj:offsetGet() car il n'y a rien à lire string(17) "obj::offsetExists" bool(true)