User Guide

Table Of Contents
108 Chapter 5: Using Arrays and Structures
Array functions
The following functions are available for creating, editing, and handling arrays:
For more information about each of these functions, see CFML Reference.
About structures
ColdFusion structures consist of key-value pairs. Structures let you build a collection of related
variables that are grouped under a single name. You can define ColdFusion structures
dynamically.
You can use structures to refer to related values as a unit, rather than individually. To maintain
employee lists, for example, you can create a structure that holds personnel information such as
name, address, phone number, ID numbers, and so on. Then you can refer to this collection of
information as a structure called employee rather than as a collection of individual variables.
Function Description
ArrayAppend Appends an array element to the end of a specified array.
ArrayAvg Returns the average of the values in the specified array.
ArrayClear Deletes all data in a specified array.
ArrayDeleteAt Deletes an element from a specified array at the specified index and resizes the
array.
ArrayInsertAt Inserts an element (with data) in a specified array at the specified index and
resizes the array.
ArrayIsEmpty Returns True if the specified array is empty of data.
ArrayLen Returns the length of the specified array.
ArrayMax Returns the largest numeric value in the specified array.
ArrayMin Returns the smallest numeric value in the specified array.
ArrayNew Creates a new array of specified dimension.
ArrayPrepend Adds an array element to the beginning of the specified array.
ArrayResize Resets an array to a specified minimum number of elements.
ArraySet Sets the elements in a 1D array in a specified range to a specified value.
ArraySort Returns the specified array with elements sorted numerically or
alphanumerically.
ArraySum Returns the sum of values in the specified array.
ArraySwap Swaps array values in the specified indexes.
ArrayToList Converts the specified 1D array to a list, delimited with the character you specify.
IsArray Returns True if the value is an array.
ListToArray Converts the specified list, delimited with the character you specify, to an array.