Проверяет, принадлежит ли объект к данному классу или содержит данный класс в числе своих предков


(PHP 4 >= 4.2.0, PHP 5)

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() - Проверяет, содержит ли объект в своем дереве предков указанный класс