Whatever message this page gives is out now! Go check it out!
IsInstanceOf
Last update:
May 18, 2026
Description
Determines whether an object is an instance of a ColdFusion interface or component, or of a Java class.
Returns
Returns true if any of the following is true:
- The object specified by the first parameter is an instance of the interface or component specified by the second parameter.
- The Java object specified by the first parameter was created by using the cfobject tag or CreateObject method and is an instance of the Java class specified by the second parameter.
- The object specified by the first parameter is an instance of a component that extends the component specified in the second parameter.
- The object specified by the first parameter is an instance of a component that extends a component that implements the interface specified in the second parameter.
- The Java object specified by the first parameter was created by using the cfobject tag or CreateObjectmethod and is an instance of a Java class that extends the class specified by the second parameter.Returns false otherwise.
Note:
The isInstanceOf function returns false if the CFC specified by the object parameter does not define any functions.
Category
Syntax
IsInstanceOf(object, typeName)See also
History
ColdFusion 8: Added this function.
Parameters
| Parameter | Description |
object | The CFC instance or Java object that you are testing |
typeName | The name of the interface, component, or Java class of which the object might be an instance |
Usage
For Java objects, the comparison is valid only if you created the object specified in the first parameter by using a cfobject tag or CreateObject method.
Example
<cfscript>
output = isInstanceOf("component","c1");
output1 = isInstanceOf("java","java.system.lang");
writeoutput(output & "<br>");
writeoutput(output1);
</cfscript>Output
NO
NO
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Share additional feedback to help us improve.
0/255
|
