– Common Function Library Project

ListLeft(list, numElements [, delimiter])

Last updated April 24, 2002

Version: 1 | Requires: ColdFusion 5 | Library: StrLib

Rated 1 time(s). Average Rating: 5.0

A Left() function for lists. Returns the n leftmost elements from the specified list. Accepts an optional delimiter. Note that if the number of elements to return is greater than the number of elements in the list, the UDF simply returns all elements.

Return Values:
Returns a string,


view plain print about
<CFSET List="1,2,3,4,5,6,7,8,9,10">
<CFSET List2="a,b,c,d,e,f,g,h">

#ListLeft(List, 3)#<BR>
#ListLeft(List2, 50)#


Name Description Required
list List you want to return the n leftmost elements from. Yes
numElements Number of leftmost elements you want returned. Yes
delimiter Delimiter for the list. Default is the comma. No

Full UDF Source:

view plain print about
 * A Left() function for lists.  Returns the n leftmost elements from the specified list.
 * @param list      List you want to return the n leftmost elements from. 
 * @param numElements      Number of leftmost elements you want returned. 
 * @param delimiter      Delimiter for the list.  Default is the comma. 
 * @return Returns a string, 
 * @author Rob Brooks-Bilson ( 
 * @version 1, April 24, 2002 

function ListLeft(list, numElements){
  var tempList="";
  var i=0;
  var delimiter=",";
  if (ArrayLen(arguments) gt 2){
    delimiter = arguments[3];
  if (numElements gte ListLen(list, delimiter)){
    return list;
  for (i=1; i LTE numElements; i=i+1){
    tempList=ListAppend(tempList, ListGetAt(list, i, delimiter), delimiter);
  return tempList;
blog comments powered by Disqus


Latest Additions

CF Ninja CF Ninja added
14 day(s) ago

Stephen Withington Stephen Withington added
14 day(s) ago

Adam Cameron Adam Cameron added
a while ago

Ray Ford Ray Ford added
a while ago

Top Rated

Darwan Leonardo Sitepu backupDatabase
Rated 5.0, 48 time(s)

Barney Boisvert indentXml
Rated 5.0, 12 time(s)

Rachel Lehman deAccent
Rated 5.0, 9 time(s)

Darwan Leonardo Sitepu splitNumber
Rated 5.0, 8 time(s)

Created by Raymond Camden / Design by Justin Johnson