CFLib.org – arrayTrim

arrayTrim()

Last updated January 31, 2012

Download UDF

author

Tayo Akinmade
Send Email

Version: 1 | Requires: ColdFusion MX | Library: DataManipulationLib

Rated 0 time(s). Average Rating: 0

Description:
This UDF trims an array to a specified number of elements. Triming is from right to left by default.

Return Values:
Returns an array.

Example:

view plain print about

<cfset aPlayers = arrayNew(1)>

<cfset aPlayers[1] = "Rooney">
<cfset aPlayers[2] = "Berbatov">
<cfset aPlayers[3] = "Gigs">
<cfset aPlayers[4] = "Scholes">
<cfset aPlayers[5] = "Ronaldo">
<cfset aPlayers[6] = "Beckham">

<cfset aPlayers = arrayTrim(aPlayers,4)>

<cfdump var="#aPlayers#">

Parameters:

No arguments.

Full UDF Source:

	
	
			
			
			
				
				view plain
				
				
				copy to clipboard
				
				
				
				
				print
				
				
				about
				ColdFISH is developed by Jason Delmore.  Source code and license information available at coldfish.riaforge.org.  Version 3.1.1
				
			<!---
 This method trims an array to the specified number of elements.
 
 @return Returns an array. 
 @author Tayo Akinmade (&#111;&#108;&#117;&#115;&#105;&#110;&#97;&#64;&#104;&#111;&#116;&#109;&#97;&#105;&#108;&#46;&#99;&#111;&#109;) 
 @version 1, January 31, 2012 
--->
<cffunction name="arrayTrim" access="public" returntype="array" output="false" hint="This method trims an array to the specified number of elements. Triming is from right to left by default">
	<cfargument name="aArray" type="array" required="true" hint="The array to be trimed">
	<cfargument name="iLength" type="numeric" required="true" hint="The length the array is to be trimmed to">
	<cfargument name="sTrimFrom" type="string" required="false" hint="Direction of the array trim. RIGHT->LEFT|R, LEFT-RIGHT|L" default="L">
	<cfscript>
		var stLocal							= structNew();

		stLocal.aTrimmedArray 				= arguments.aArray;										// set trimmed array
		stLocal.iLoopIteration				= arrayLen(stLocal.aTrimmedArray)-arguments.iLength; 	// get number of delete iterations

		// check if new length is less that the current length
		if(arguments.iLength lt  arrayLen(stLocal.aTrimmedArray)){
			for(stLocal.i = 1; stLocal.i lte stLocal.iLoopIteration;stLocal.i = stLocal.i + 1){
				// get index of array element to delete
				if(compareNoCase(arguments.sTrimFrom,"R") EQ 0){
					stLocal.iDeleteIindex	=  arrayLen(stLocal.aTrimmedArray);
				}
				else{
					stLocal.iDeleteIindex	= 1;
				}

				// delete array element
				arrayDeleteAt(stLocal.aTrimmedArray, stLocal.iDeleteIindex);
			}
		}

		return stLocal.aTrimmedArray;
	</cfscript>
</cffunction>
		<!---
 This method trims an array to the specified number of elements.
 
 @return Returns an array. 
 @author Tayo Akinmade (olusina@hotmail.com) 
 @version 1, January 31, 2012 
--->
<cffunction name="arrayTrim" access="public" returntype="array" output="false" hint="This method trims an array to the specified number of elements. Triming is from right to left by default">
    <cfargument name="aArray" type="array" required="true" hint="The array to be trimed">
    <cfargument name="iLength" type="numeric" required="true" hint="The length the array is to be trimmed to">
    <cfargument name="sTrimFrom" type="string" required="false" hint="Direction of the array trim. RIGHT->LEFT|R, LEFT-RIGHT|L" default="L">
    <cfscript>
        var stLocal                            = structNew();

        stLocal.aTrimmedArray                 = arguments.aArray;                                        // set trimmed array
        stLocal.iLoopIteration                = arrayLen(stLocal.aTrimmedArray)-arguments.iLength;     // get number of delete iterations

        // check if new length is less that the current length
        if(arguments.iLength lt  arrayLen(stLocal.aTrimmedArray)){
            for(stLocal.i = 1; stLocal.i lte stLocal.iLoopIteration;stLocal.i = stLocal.i + 1){
                // get index of array element to delete
                if(compareNoCase(arguments.sTrimFrom,"R") EQ 0){
                    stLocal.iDeleteIindex    =  arrayLen(stLocal.aTrimmedArray);
                }
                else{
                    stLocal.iDeleteIindex    = 1;
                }

                // delete array element
                arrayDeleteAt(stLocal.aTrimmedArray, stLocal.iDeleteIindex);
            }
        }

        return stLocal.aTrimmedArray;
    </cfscript>
</cffunction>