downloads | documentation | faq | getting help | mailing lists | licenses | wiki | reporting bugs | php.net sites | links | conferences | my php.net

search for in the

method_exists> <is_a
[edit] Last updated: Fri, 23 Mar 2012

view this page in

is_subclass_of

(PHP 4, PHP 5)

is_subclass_of Zwraca TRUE jeżeli klasa jest jednym z przodków obiektu

Opis

bool is_subclass_of ( mixed $obiekt , string $nazwa_klasy )

Funkcja ta zwraca TRUE jeżeli obiekt obiekt należy do klasy która jest podklasą klasy nazwa_klasy, FALSE w przeciwnym przypadku.

Informacja:

Od PHP 5.0.3 możesz określić parametr object także jako łańcuch znaków (nazwę klasy).

Przykład #1 is_subclass_of() przykład

<?php
// definicja klasy
class WidgetFactory
{
  var 
$oink 'moo';
}

// definicja klasy potomnej
class WidgetFactory_Child extends WidgetFactory
{
  var 
$oink 'oink';
}

// tworzenie nowego obiektu
$WF = new WidgetFactory();
$WFC = new WidgetFactory_Child();

if (
is_subclass_of($WFC'WidgetFactory')) {
  echo 
"tak, \$WFC jest pod klasą WidgetFactory\n";
} else {
  echo 
"nie, \$WFC nie jest pod klasą WidgetFactory\n";
}


if (
is_subclass_of($WF'WidgetFactory')) {
  echo 
"tak, \$WF jest pod klasą WidgetFactory\n";
} else {
  echo 
"nie, \$WF nie jest pod klasą WidgetFactory\n";
}


// użyteczne dopiero od PHP 5.0.3
if (is_subclass_of('WidgetFactory_Child''WidgetFactory')) {
  echo 
"tak, WidgetFactory_Child jest pod klasą WidgetFactory\n";
} else {
  echo 
"nie, WidgetFactory_Child nie jest pod klasą WidgetFactory\n";
}
?>

Powyższy przykład wyświetli:

tak, $WFC jest pod klasą WidgetFactory
nie, $WF nie jest pod klasą WidgetFactory
tak, WidgetFactory_Child jest pod klasą WidgetFactory

Patrz także: get_class(), get_parent_class(), is_a().



method_exists> <is_a
[edit] Last updated: Fri, 23 Mar 2012
 
add a note add a note User Contributed Notes is_subclass_of
nicholas at aquarionics dot com 17-Mar-2009 03:02
This might be useful to someone, so:

If you're using Autoload, you should be aware that this will attempt to autoload $classname if it isn't already loaded. I discovered this when I had something using is_subclass_of inside an error thrown by autoload, which then recursed until it ran out of memory.
Damien Bezborodov 16-Mar-2009 06:55
If you need something similar to is_subclass_of() to determine if a class implements an interface before instantiating it, use reflection:

<?php

interface A_Interface {}
class
A implements A_Interface {}

$reflectionA = new ReflectionClass('A');
var_dump(
   
$reflectionA->implementsInterface('A_Interface')
);

?>
bool(true)
kostyl_kostyl gav-gav mail point ru 07-Mar-2009 05:08
<?php
interface I {
}
class
A implements I {
}
class
B extends {
}
if (
is_subclass_of('A', 'I')) {
    echo
'good<br>';
}
else {
    echo
'bad<br>';
}
if (
is_subclass_of('B', 'I')) {
    echo
'good<br>';
}
else {
    echo
'bad<br>';
}
if (
is_subclass_of('B', 'A')) {
    echo
'good<br>';
}
else {
    echo
'bad<br>';
}
?>

result:
bad <- you must to describe intermediate class B to be good
good
good
jm 30-Sep-2008 11:02
It would appear that is_subclass_of is case insensitive unlike get_class in php5.
i.e.

<?php
class fooBar {}
class
bar extends fooBar {}

assert(get_class(new fooBar()) == "fooBar");
assert(is_subclass_of(new bar(), "foobar") == true);
?>

i run across this while migrating some code from php4 to php5 and the code would only half-the-time break.
Ondra Zizka 13-Oct-2006 08:31
For PHP4:

<?php
/** Returns whether specified class is subclass of the other class. */
function is_subclass($sClass, $sExpectedParentClass){
    do if(
$sExpectedParentClass === $sClass ) return true;
    while(
false != ($sClass = get_parent_class($sClass)) );
    return
false;
}
// Test:
class A {} class B extends A {} class C extends B {} echo (int) is_subclass('C', 'A');
?>
gunniboyh at web dot de 20-May-2006 09:16
is_subclass_of() works also with classes between the class of obj and the superclass.

example:
<?php
class A {};
class
B extends A {};
class
C extends B {};

$foo=new C();
echo ((
is_subclass_of($foo,'A')) ? 'true' : 'false');
?>

echoes 'true' .
01-Oct-2005 09:32
this function does not check interfaces, unlike instanceof operator.
youcantryreachingme at REMOVEME dot hotmail dot com 21-Mar-2005 08:15
A bug report at http://pear.php.net/bugs/bug.php?id=2975 indicates that the "is_subclass_of" function can return the error message:

Warning: Unknown class passed as parameter

in the event that the class represented by the second argument hasn't yet been instantiated.

 
show source | credits | stats | sitemap | contact | advertising | mirror sites