(PHP 5 >= 5.0.0)
ArrayAccess::offsetExists — Определяет, существует ли заданное смещение (ключ)
Описание
abstract public boolean ArrayAccess::offsetExists ( mixed $offset )
Определяет, существует или нет данное смещение (ключ).
Данный метод исполняется, когда используется функция isset() или функция empty() для объекта, реализующего интерфейс ArrayAccess.
Замечание:
Когда используется функция empty(), метод ArrayAccess::offsetGet() вызывается и результат проверяется только в случае, если метод ArrayAccess::offsetExists() возвращает TRUE.
Список параметров
offset
Смещение (ключ) для проверки.
Возвращаемые значения
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Замечание:
Возвращаемое значение будет приведено к логическому типу, если возвращаемое значение не является логическим.
Примеры
Пример #1 Пример использования ArrayAccess::offsetExists()
<?php
class obj implements arrayaccess {
public function offsetSet($offset, $value) {
var_dump(__METHOD__);
}
public function offsetExists($var) {
var_dump(__METHOD__);
if ($var == "foobar") {
return true;
}
return false;
}
public function offsetUnset($var) {
var_dump(__METHOD__);
}
public function offsetGet($var) {
var_dump(__METHOD__);
return "value";
}
}
$obj = new obj;
echo "Выполняется obj::offsetExists()\n";
var_dump(isset($obj["foobar"]));
echo "\nВыполняется obj::offsetExists() и obj::offsetGet()\n";
var_dump(empty($obj["foobar"]));
echo "\nВыполняется obj::offsetExists(), но *не* obj:offsetGet() поскольку нечего возвращать\n";
var_dump(empty($obj["foobaz"]));
?>
Результатом выполнения данного примера будет что-то подобное:
Выполняется obj::offsetExists()
string(17) "obj::offsetExists"
bool(true)
Выполняется obj::offsetExists() и obj::offsetGet()
string(17) "obj::offsetExists"
string(14) "obj::offsetGet"
bool(false)
Выполняется obj::offsetExists(), но *не* obj:offsetGet() поскольку нечего возвращать
string(17) "obj::offsetExists"
bool(true)