arrayLen

Determines the largest index in an array.
For dense arrays, this corresponds to the number of elements in the array.
CF MX: this function can be used on child XML objects.

arrayLen(array) → returns numeric

Member Function Syntax

someArray.len()

Argument Reference

array array
Required

An array from which to get the final index.

Compatibility

ColdFusion:

Version 3+ The member function cannot be called on literals

Links more information about arrayLen

[ANeff] Bug for: member functions cannot be called on literals (continuation of CF-3712122) - Adobe bug ticket to add literal support to struct and array member functions

Examples
Sample code invoking the arrayLen function

Using arrayLen to get the length of a dense array

Uses the arrayLen function to get the total length of a dense array

numberArray = [1,2,3,4];
writeOutput(arrayLen(numberArray));

Expected Result: 4

Using member function to get the length of a dense array

CF 11+ Lucee 4.5+ Using the len member function is the same as running arrayLen.

colorArray = ['Green','red','blue'];
writeOutput(colorArray.len());

Expected Result: 3

Using arrayLen on a sparse array

Uses the arrayLen function to get the largest index of a spare array

sparseArray = [];
sparseArray[42] = 42;
writeOutput(arrayLen(sparseArray));

Expected Result: 42

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub