Whatever message this page gives is out now! Go check it out!
structValueArray
Last update:
May 18, 2026
Description
The function converts all values in a struct as an array of values.
Returns
An array of values.
History
- ColdFusion (2025 release): Added the function.
Syntax
structvalueArray(structName)Member function
structName.valueArray()Parameters
Parameter | Description |
structName | A structure whose values need to be returned as an array. |
Example 1
<cfscript>
myStruct=StructNew("Ordered");
myStruct.item1="Old Trafford";
myStruct.item2="Anfield";
myStruct.item3="Stamford Bridge";
myStruct.item4="Villa Park";
myStruct.item5="St James Park";
myStruct.item6="Emirates Stadium";
myStruct.item7="Etihad Stadium";
// print the values as array
writeDump(StructValueArray(myStruct));
</cfscript>
Example 2- using nested structs
<cfscript>
mainStruct=structNew()
mainStruct.name = "John Doe"
mainStruct.age = 30
mainStruct.address = StructNew()
mainStruct.address.street = "123 Main St"
mainStruct.address.city = "Anytown"
mainStruct.address.state = "CA"
mainStruct.address.zip = "12345"
mainStruct.phoneNumbers = ["555-1234", "555-5678"]
mainStruct.employees = []
employee1 = StructNew()
employee1.name = "Jane Smith"
employee1.position = "Manager"
ArrayAppend(mainStruct.employees, employee1)
employee2 = StructNew()
employee2.name = "Bob Johnson"
employee2.position = "Developer"
ArrayAppend(mainStruct.employees, employee2)
mainStruct.company = StructNew()
mainStruct.company.name = "Tech Solutions"
mainStruct.company.departments = []
department1 = StructNew()
department1.name = "IT"
department1.employees = []
employee3 = StructNew()
employee3.name = "Alice Walker"
employee3.role = "SysAdmin"
ArrayAppend(department1.employees, employee3)
writeDump(mainStruct)
writeOutput("<br/>")
// print the values as array
writeDump(StructValueArray(mainStruct))
</cfscript>Example 3- using member function
<cfscript>
myStruct=StructNew("Ordered");
myStruct.item1="Old Trafford";
myStruct.item2="Anfield";
myStruct.item3="Stamford Bridge";
myStruct.item4="Villa Park";
myStruct.item5="St James Park";
myStruct.item6="Emirates Stadium";
myStruct.item7="Etihad Stadium";
// print the values as array- member function
writeDump(myStruct.valueArray())
</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
|
