CFLib.org – Common Function Library Project

Description:
Returns a slice of an array.

Return Values:
Returns an array.

Example:

<cfscript>
	a = arrayNew(1);
	a[1] = "this";
	a[2] = "is";
	a[3] = "the";
	a[4] = "best";
	a[5] = "udf";
	a[6] = "that";
	a[7] = "has";
	a[8] = "ever";
	a[9] = "been";
	a[10] = "written";
</cfscript>

<cfdump var="#a#">
<cfdump var="#arrayslice(a, 2, 3)#">
<cfdump var="#arrayslice(a, 7)#">
<cfdump var="#arrayslice(a)#">

Parameters:

Full UDF Source:

<cfscript>
/**
 * Slices an array.
 * 
 * @param ary 	 The array to slice. (Required)
 * @param start 	 The index to start with. Defaults to 1. (Optional)
 * @param finish 	 The index to end with. Defaults to the end of the array. (Optional)
 * @return Returns an array. 
 * @author Darrell Maples (&#100;&#114;&#109;&#97;&#112;&#108;&#101;&#115;&#64;&#103;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;) 
 * @version 1, July 13, 2005 
 */
function arraySlice(ary) {
	var start = 1;
	var finish = arrayLen(ary);
	var slice = arrayNew(1);
	var j = 1;

	if (len(arguments[2])) { start = arguments[2]; };
	if (len(arguments[3])) { finish = arguments[3]; };

	for (j=start; j LTE finish; j=j+1) {
		arrayAppend(slice, ary[j]);
	}
	return slice;
}
</cfscript>