is_a

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

is_a — Prüft, ob ein Objekt vom angegebenen Typ oder untergeordneten Typ ist

Beschreibung

is_a(mixed $object_or_class, string $class, bool $allow_string = false): bool

Ermittelt, ob das angegebene object_or_class vom Objekttyp class ist oder class als einen seiner Elterntypen hat.

Parameter-Liste

object_or_class: Der Name einer Klasse oder ein Objekt
class: Der Name einer Klasse oder Schnittstelle
allow_string: Wenn dieser Parameter auf false gesetzt ist, ist beim Parameter object_or_class kein Klassenname erlaubt. Dadurch wird auch verhindert, dass der Autoloader aufgerufen wird, wenn die Klasse nicht existiert.

Rückgabewerte

Gibt true zurück, wenn object_or_class vom Objekttyp class ist oder class als einen seiner Elterntypen hat, andernfalls wird false zurückgegeben.

Beispiele

Beispiel #1 is_a()-Beispiel

<?php
// eine Klasse definieren
class WidgetFactory
{
  var $oink = 'moo';
}

// ein neues Objekt erstellen
$WF = new WidgetFactory();

if (is_a($WF, 'WidgetFactory')) {
  echo "Ja, \$WF ist immer noch eine a WidgetFactory\n";
}
?>

Beispiel #2 Verwendung des instanceof-Operators

<?php
if ($WF instanceof WidgetFactory) {
    echo 'Ja, $WF ist eine WidgetFactory';
}
?>

Siehe auch

get_class() - Ermittelt den Klassennamen eines Objekts
get_parent_class() - Gibt den Namen der Elternklasse eines Objektes zurück
is_subclass_of() - Prüft ob ein Objekt von der angegebenen Klasse abstammt oder sie implementiert