IsObject

Description

Determines whether a value is an object.

Returns

True, if the value represents a ColdFusion object. False if the value is any other type of data, such as an integer, string, date, or struct.

Function syntax

IsObject(value)

History

ColdFusion MX: Added this function.

Parameters

Parameter

Description

value

A value, typically the name of a variable.

Usage

This function returns False for query and XML objects.

Example

<!--- to use this example, create a color.cfc component as follows: ---> 
<!---  
<cfcomponent> 
<cffunction name="myFunction" access="public" returntype="string"> 
<!--- Create a structure object ---> 
        <cfset myColor = "Blue"> 
        <cfreturn myColor> 
</cffunction> 
</cfcomponent> 
---> 
 
<!--- Create an instance of the color.cfc component ---> 
<cfobject name="getColor" component="color"> 
 
<cfif IsObject(getColor)> 
    <!--- Invoke the myFunction method ---> 
    <cfinvoke 
        component="#getColor#" 
        method="myFunction" 
        returnVariable="myColor"> 
    </cfinvoke> 
 
    <cfif IsDefined("myColor")> 
        <!--- Output the returned variable ---> 
        The value of myColor = <cfoutput>#myColor#</cfoutput><p> 
    </cfif> 
</cfif>