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.

Category

Decision functions

Function syntax

IsObject(value)

See also

IsDate, IsImage, IsNumeric, IsNumericDate, IsQuery, IsSimpleValue, IsStruct, IsWDDX, IsXmlDoc, IsXmlElem, IsXmlRoot

History

ColdFusion MX: Added this function.

Parameters

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>