Whatever message this page gives is out now! Go check it out!
StructDelete
Last update:
May 18, 2026
Description
Removes an element from a structure.
Returns
Returns true, if an element is deleted successfully. False, otherwise.
Category
Syntax
StructDelete(structure, key [, indicatenotexisting ])See also
Structure functions; Modifying a ColdFusion XML object in the Developing ColdFusion Applications
History
ColdFusion MX: Changed behavior: this function can be used on XML objects.
Parameters
Parameter | Description |
structure | Structure or a variable that contains one. Contains element to remove. |
key | Element to remove. |
indicatenotexisting |
|
Example
<cfscript>
myStruct={a:1,b:2,c:3,d:4,e:5};
WriteOutput("The input struct is:");
WriteDump(myStruct);
xFalse=StructDelete(myStruct,"f",false);// Returns Yes regardless of whether key exists
WriteOutput(xFalse & " | "); //Display Yes
xTrue=StructDelete(myStruct,"f","true");// Returns No since the key "f" does not exist in the input struct
WriteOutput(xTrue & " | "); //Display No
// Delete an element that actually exists in the input structure
StructDelete(myStruct,"e",true); // Deletes element "e" from the struct and returns Yes
WriteOutput("The updated struct is:");
WriteDump(myStruct);
</cfscript>Output
Using member function
<cfscript>
myStruct={a:1,b:2,c:3,d:4,e:5};
WriteOutput(myStruct.delete("c",true));
</cfscript>
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Share additional feedback to help us improve.
0/255
|
