User Guide Cancel

DeleteClientVariable

 

Description

Deletes a client variable. (To test for the existence of a variable, use IsDefined.)

Returns

True, if the variable is successfully deleted; false, otherwise.

Category

Other functions

Function syntax

DeleteClientVariable(name)
DeleteClientVariable(name)
DeleteClientVariable(name)

See also

GetClientVariablesList

History

ColdFusion MX: Changed behavior: if the variable is not present, this function now returns False. (In earlier releases, it threw an error.)

Parameters

Parameter

Description

name

Name of a client variable to delete, surrounded by double-quotation marks

Example

<!--- This view-only example shows DeleteClientVariable --->
<HTML>
<HEAD>
<TITLE>DeleteClientVariable Example</TITLE>
</HEAD>
<BODY>
<!--- this example is view only --->
<H3>DeleteClientVariable Example</H3>
<P>This view-only example deletes a client variable called
"User_ID", if it exists in the list of client variables
returned by GetClientVariablesList().
<P>This example requires the existance of an Application.cfm file
and that client management be in effect.
<!---
<CFSET client.somevar="">
<CFSET client.user_id="">
<P>Client variable list:<CFOUTPUT>#GetClientVariablesList()#</CFOUTPUT>
<CFIF ListFindNoCase(GetClientVariablesList(), "User_ID") is not 0>
<!--- delete that variable --->
<CFSET temp = DeleteClientVariable("User_ID")>
<P>Was variable "User_ID" Deleted? <CFOUTPUT>#temp#</CFOUTPUT>
</CFIF>
<P>Amended Client variable list:<CFOUTPUT>#GetClientVariablesList()#
</CFOUTPUT>
</BODY>
</HTML>
<!--- This view-only example shows DeleteClientVariable ---> <HTML> <HEAD> <TITLE>DeleteClientVariable Example</TITLE> </HEAD> <BODY> <!--- this example is view only ---> <H3>DeleteClientVariable Example</H3> <P>This view-only example deletes a client variable called "User_ID", if it exists in the list of client variables returned by GetClientVariablesList(). <P>This example requires the existance of an Application.cfm file and that client management be in effect. <!--- <CFSET client.somevar=""> <CFSET client.user_id=""> <P>Client variable list:<CFOUTPUT>#GetClientVariablesList()#</CFOUTPUT> <CFIF ListFindNoCase(GetClientVariablesList(), "User_ID") is not 0> <!--- delete that variable ---> <CFSET temp = DeleteClientVariable("User_ID")> <P>Was variable "User_ID" Deleted? <CFOUTPUT>#temp#</CFOUTPUT> </CFIF> <P>Amended Client variable list:<CFOUTPUT>#GetClientVariablesList()# </CFOUTPUT> </BODY> </HTML>
<!--- This view-only example shows DeleteClientVariable --->
<HTML>
<HEAD>
<TITLE>DeleteClientVariable Example</TITLE>
</HEAD>

<BODY>
<!--- this example is view only --->
<H3>DeleteClientVariable Example</H3>

<P>This view-only example deletes a client variable called
"User_ID", if it exists in the list of client variables
returned by GetClientVariablesList().
<P>This example requires the existance of an Application.cfm file
and that client management be in effect.
<!--- 
<CFSET client.somevar="">
<CFSET client.user_id="">
<P>Client variable list:<CFOUTPUT>#GetClientVariablesList()#</CFOUTPUT>
<CFIF ListFindNoCase(GetClientVariablesList(), "User_ID") is not 0>
<!--- delete that variable --->
    <CFSET temp = DeleteClientVariable("User_ID")>
    <P>Was variable "User_ID" Deleted? <CFOUTPUT>#temp#</CFOUTPUT>
</CFIF>

<P>Amended Client variable list:<CFOUTPUT>#GetClientVariablesList()#
  </CFOUTPUT>

</BODY>
</HTML> 

Get help faster and easier

New user?