is_a

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

is_aПроверяет, принадлежит ли объект к данному классу или является ли этот класс одним из его родителей

Описание

bool is_a ( object $object , string $class_name [, bool $allow_string = FALSE ] )

Проверяет, принадлежит ли объект object к данному классу или является ли этот класс одним из его родителей.

Список параметров

object

Проверяемый объект

class_name

Имя класса

allow_string

Если параметр установлен в FALSE, то не допускается имя класса в виде строки в качестве параметра object. Это также предотвращает вызов автозагрузчика, если класс не существует.

Возвращаемые значения

Возвращает TRUE, если объект принадлежит данному классу или является ли этот класс одним из его родителей, иначе возвращается FALSE.

Список изменений

Версия Описание
5.3.9 Добавлен параметр allow_string
5.3.0 Данная функция больше не считается устаревшей, а значит больше не будет выводить предупреждения E_STRICT.
5.0.0 Эта функция была помечена устаревшей в пользу оператора instanceof. Вызов данной функции вызовет предупреждение уровня E_STRICT.

Примеры

Пример #1 Пример использования is_a()

<?php
// объявление класса
class WidgetFactory
{
  var 
$oink 'moo';
}

// создание нового объекта
$WF = new WidgetFactory();

if (
is_a($WF'WidgetFactory')) {
  echo 
"да, \$WF все еще WidgetFactory\n";
}
?>

Пример #2 Использование оператора instanceof в PHP 5

<?php
if ($WF instanceof WidgetFactory) {
    echo 
'Да, $WF - WidgetFactory';
}
?>

Смотрите также

  • get_class() - Возвращает имя класса, к которому принадлежит объект
  • get_parent_class() - Возвращает имя родительского класса для объекта или класса
  • is_subclass_of() - Проверяет, содержит ли объект в своем дереве предков указанный класс либо прямо реализует его