is_subclass_of

(PHP 4, PHP 5)

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

Описание

bool is_subclass_of ( mixed $object , string $class_name [, bool $allow_string = TRUE ] )

Проверяет, содержит ли объект object в своем дереве предков класс class_name .

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

object: Имя класса или экземпляр объекта
class_name: Имя класса
allow_string: Вызывать ли автозагрузку класса, если он не существует.

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

Эта функция возвращает TRUE, если объект object принадлежит к классу, наследующему от class_name, иначе она возвращает FALSE.

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

Версия	Описание
5.3.9	Добавлен параметр `allow_string`
5.0.3	Вы также можете передать параметр `object` в виде строки (имени класса)

Примеры

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


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

// объявляем наследника
class WidgetFactory_Child extends WidgetFactory
{
  var $oink = 'oink';
}

// создаем новый объект
$WF = new WidgetFactory();
$WFC = new WidgetFactory_Child();

if (is_subclass_of($WFC, 'WidgetFactory')) {
  echo "да, \$WFC наследует WidgetFactory\n";
} else {
  echo "нет, \$WFC не наследует WidgetFactory\n";
}


if (is_subclass_of($WF, 'WidgetFactory')) {
  echo "да, \$WF наследует WidgetFactory\n";
} else {
  echo "нет, \$WF не наследует WidgetFactory\n";
}


// применимо только с версии PHP 5.0.3
if (is_subclass_of('WidgetFactory_Child', 'WidgetFactory')) {
  echo "да, WidgetFactory_Child наследует WidgetFactory\n";
} else {
  echo "нет, WidgetFactory_Child не наследует WidgetFactory\n";
}
?>

Результат выполнения данного примера:

да, $WFC наследует WidgetFactory
нет, $WF не наследует WidgetFactory
да, WidgetFactory_Child наследует WidgetFactory

Примечания

Замечание:
Вызов этой функции будет использовать все зарегистрированные функции автозагрузки, если класс еще не известен.

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

get_class() - Возвращает имя класса, к которому принадлежит объект
get_parent_class() - Возвращает имя родительского класса для объекта или класса
is_a() - Проверяет, принадлежит ли объект к данному классу или содержит данный класс в числе своих предков
class_parents() - Return the parent classes of the given class