isObject

Description

Determines whether a value is an object.

Categories

Related

History

ColdFusion MX: Added this function.

Syntax

IsObject(value)

Attributes

AttributeDescriptionRequiredDefault
valueA value, typically the name of a variable.

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.

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> 
    </cfif> 
</cfif>