CFLib.org – Common Function Library Project

Description:
Deletes the first element in a given array, then inserts a new element at the end of the array, creating a first in first out effect.

Return Values:
Returns an array.

Example:

<cfset myArray = ArrayNew(1)>

<cfset myArray[1] = "First In"> 
<cfset myArray[2] = "Second In"> 
<cfset myArray[3] = "Third In"> 
<cfset myArray[4] = "Fourth In">

<cfoutput>
Before:<br>
<cfloop from="1" to="#ArrayLen(myArray)#" index="i">
   #myArray[i]#<br>
</cfloop>
</cfoutput>

<cfset myArray = FirstInFirstOut( myArray, "New Value" )>

<cfoutput>
<br>After:<br>
<cfloop from="1" to="#ArrayLen(myArray)#" index="i">
   #myArray[i]#<br>
</cfloop>
</cfoutput>

Parameters:

Full UDF Source:

<cfscript>
/**
 * Removes the element at index one and inserts a new element at the highest index plus one.
 * 
 * @param array 	 Array to modify. (Required)
 * @param valueToAdd 	 Value to add. (Required)
 * @return Returns an array. 
 * @author Adrian Lynch (&#97;&#100;&#114;&#105;&#97;&#110;&#46;&#108;&#64;&#116;&#104;&#111;&#117;&#103;&#104;&#116;&#98;&#117;&#98;&#98;&#108;&#101;&#46;&#110;&#101;&#116;) 
 * @version 1, May 13, 2003 
 */
function FirstInFirstOut( array, valueToAdd ) {

	// Delete element at index 1
	ArrayDeleteAt( array, 1 );
	
	// Add new element at last index plus one
	array[ArrayLen( array ) + 1] = valueToAdd;
	
	return array;
	
}
</cfscript>