<?xml version="1.0" encoding="utf-8"?>

<refentry xml:id="function.is-a" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>is_a</refname>

<refpurpose>Проверяет, принадлежит ли объект типу или подтипу</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type>bool</type><methodname>is_a</methodname>

<methodparam><type>mixed</type><parameter>object_or_class</parameter></methodparam>

<methodparam><type>string</type><parameter>class</parameter></methodparam>

<methodparam choice="opt"><type>bool</type><parameter>allow_string</parameter><initializer>&false;</initializer></methodparam>

</methodsynopsis>

<para>

Функция определяет, принадлежит ли объект или класс <parameter>object_or_class</parameter>

типу <parameter>class</parameter>, или относится ли тип объекта или класса

к подтипу супертипа <parameter>class</parameter>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>object_or_class</parameter></term>

<listitem>

<para>

Название класса или экземпляр объекта.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>class</parameter></term>

<listitem>

<para>

Название класса или интерфейса.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><parameter>allow_string</parameter></term>

<listitem>

<para>

Со значением &false; функция определит соответствие типов,

только если в параметр <parameter>object_or_class</parameter>

передали экземпляр объекта, а не название класса.

Это также предотвратит вызов автозагрузчика, если класс не загрузили прежде.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Функция возвращает &true;, если тип <parameter>object_or_class</parameter>

принадлежит типу <parameter>class</parameter>

или относится к подтипу супертипа <parameter>class</parameter>,

иначе возвращает значение &false;.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Пример проверки принадлежности типа функцией <function>is_a</function></title>

<programlisting role="php">

</programlisting>

</example>

<example>

<title>Пример проверки типа оператором <emphasis>instanceof</emphasis></title>

<programlisting role="php">

</programlisting>

</example>

</para>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>get_class</function></member>

<member><function>get_parent_class</function></member>

<member><function>is_subclass_of</function></member>

</simplelist>

</para>

</refsect1>

</refentry>