All pages
Powered by GitBook
1 of 1

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

  • ListIndexExists

  • ListInsertAt

  • ListItemTrim

  • ListLast

  • ListLen

  • ListMap

  • ListNone

  • ListPrepend

  • ListQualify

  • ListReduceRight

  • ListRemoveDuplicates

  • ListRest

  • ListSetAt

  • ListSome

  • ListSort

  • ListToArray

  • ListTrim

  • ListValueCount

  • ListValueCountNoCase