structValueArray

 

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)
structvalueArray(structName)
structvalueArray(structName)

Member function

structName.valueArray()
structName.valueArray()
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>
<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>
<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>
code

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>
<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>
<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>
code

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>
<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>
<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>
code

Get help faster and easier

New user?