string.listFirst()

Gets the first element of a list.

string.listFirst( [ delimiters [, includeEmptyFields [, count ] ] ] )

Returns: String

Argument Description
delimiters
string, optional

Characters that separate list elements. The default value is comma.

Alias: delimiter

includeEmptyFields
boolean, optional

if set to true, empty values are included as well

count
number, optional

specifies how many items to return from the beginning of the list. default is 1.

Examples

listEx1 = "one&two&three&four";
	writedump(listEx1.listfirst('&'));
	writeoutput("<br>");
	listEx2 = "dev,LAS,lucee";
	writedump(listEx2.listfirst(''));

See also