is_a
(PHP 4 >= 4.2.0, PHP 5)
is_a — Vérifie si l'objet est une instance d'une classe donnée ou a cette classe parmi ses parents
Description
bool is_a
( object
$object
, string $class_name
[, bool $allow_string
= FALSE
] )
Vérifie si l'objet object
est une instance d'une classe donnée
ou a cette classe comme parent.
Liste de paramètres
-
object
-
L'objet testé
-
class_name
-
Le nom de la classe
-
allow_string
-
Si ce paramètre vaut
FALSE
, le nom de la classe sous forme de chaîne de caractères dans le paramètreobject
n'est pas autorisé. Ceci permet d'éviter l'appel de l'autoloader si la classe n'existe pas.
Valeurs de retour
Retourne TRUE
si l'objet est une instance de cette classe ou a cette classe comme parent,
FALSE
sinon.
Historique
Version | Description |
---|---|
5.3.9 |
Ajout du paramètre allow_string .
|
5.3.0 |
Cette fonction n'est plus obsolète, et ne lancera donc plus d'alerte
de type E_STRICT .
|
5.0.0 |
Cette fonction devient obsolète en faveur de l'opérateur
instanceof.
L'appel à cette fonction émettra une alerte de niveau
E_STRICT .
|
Exemples
Exemple #1 Exemple avec is_a()
<?php
// Définit une classe
class WidgetFactory
{
var $oink = 'moo';
}
// Crée un nouvel objet
$WF = new WidgetFactory();
if (is_a($WF, 'WidgetFactory')) {
echo "oui, \$WF est toujours un objet WidgetFactory\n";
}
?>
Exemple #2 Utilisation de l'opérateur instanceof avec PHP 5
<?php if ($WF instanceof WidgetFactory) { echo 'Oui, $WF est un WidgetFactory'; } ?>
Voir aussi
- get_class() - Retourne le nom de la classe d'un objet
- get_parent_class() - Retourne le nom de la classe parente d'un objet
- is_subclass_of() - Détermine si un objet est une sous-classe d'une classe donnée