ListFind

Return int position of value in delimited list, case sensitive or case-insenstive variations

Method Signature

ListFind(list=[string], value=[string], delimiter=[string], includeEmptyFields=[boolean], multiCharacterDelimiter=[boolean])

Arguments

Argument	Type	Required	Description	Default
list	string	true	The list to be searched.
value	string	true	The value to locate in the list or a function to filter the list
delimiter	string	false	The list delimiter(s)	,
includeEmptyFields	boolean	false	Whether to include empty fields in the search	false
multiCharacterDelimiter	boolean	false		false

Examples

Basic Example

Find item in a list and return the index.

Run Example

listFindNoCase( "apple,orange,banana", "orange" );

Result: 2

Different Delimiters

Find item in a pipe delimited list and return the index.

Run Example

listFindNoCase( "apple|orange|banana", "orange", "|" );

Result: 2

Member Syntax

listFindNoCase as a member function

Run Example

fruits = "apple|orange|banana";
writeOutput( fruits.listFindNoCase( "ORANGE", "|" ) );

Result: 2

Additional Examples

Run Example

writeOutput( listFindNoCase( "I,love,boxlang,testFile", "BOXLANG" ) ); // Expected output 3
// Member Function with @ delimiter
strList = "I@am@boxlang@dev";
writeDump( strList.listFindNoCase( "Dev", "@" ) );
 // Expected output 4

Related

• GetToken

• ListAppend

• ListAvg

• ListChangeDelims

• ListCompact

• ListContains

• ListContainsNoCase

• ListDeleteAt

• ListEach

• ListEvery

• ListFilter

• ListFindNoCase

• ListFirst

• ListGetAt

• ListGetEndings

• ListIndexExists

• ListInsertAt

• ListItemTrim

• ListLast

• ListLen

• ListMap

• ListNone

• ListPrepend

• ListQualify

• ListReduceRight

• ListRemoveDuplicates

• ListRest

• ListSetAt

• ListSome

• ListSort

• ListToArray

• ListTrim

• ListValueCount

• ListValueCountNoCase