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

This work is licensed under a Creative Commons Attribution-Noncommercial-Share Alike 3.0 Unported License  Twitter™ and Facebook posts are not covered under the terms of Creative Commons.

Legal Notices   |   Online Privacy Policy