# 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](https://try.boxlang.io/?code=eJzLySwuccvMS%2FHLd04sTtVQUEosKMhJ1ckvSsxLT9VJSswDQiUdBSWIgJKCpjUXANhmEOQ%3D)

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

```

Result: 2

### Different Delimiters

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

[Run Example](https://try.boxlang.io/?code=eJzLySwuccvMS%2FHLd04sTtVQUEosKMhJrckvSsxLT61JSswDQiUdBSWIAIhVo6Sgac0FAEQ%2FEpA%3D)

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

```

Result: 2

### Member Syntax

listFindNoCase as a member function

[Run Example](https://try.boxlang.io/?code=eJxLKyrNLClWsFVQSiwoyEmtyS9KzEtPrUlKzANCJWuu8qLMklT%2F0pKC0hINhTSwYr2czOISt8y8FL9858TiVA0FJf8gRz93VyUdBaUaJQVNBU1rLgBz2hz7)

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

```

Result: 2

### Additional Examples

[Run Example](https://try.boxlang.io/?code=eJxtjsEKgkAYhO%2F7FMOeFJY81E2CBVMIrE49gOkPLayurP9qj99q3eo6M8z3Ld4w3QKPgRNYM3Flhu7qimaiBPKsrJtJ2dASKaa1tSQVZH0vylIiRZojy1C%2BRmqZOrjtCXsRwwv1D%2FKowtCycQMWw09odGRNH6FeTOzrSMQxgnTT6w2jO5plLpbV6xT6McF3tvuxO8VldNEfD%2FFP5CDeDk9JFA%3D%3D)

```java
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](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/gettoken)
* [ListAppend](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listappend)
* [ListAvg](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listavg)
* [ListChangeDelims](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listchangedelims)
* [ListCompact](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listcompact)
* [ListContains](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listcontains)
* [ListContainsNoCase](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listcontainsnocase)
* [ListDeleteAt](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listdeleteat)
* [ListEach](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listeach)
* [ListEvery](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listevery)
* [ListFilter](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listfilter)
* [ListFindNoCase](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listfindnocase)
* [ListFirst](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listfirst)
* [ListGetAt](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listgetat)
* [ListGetEndings](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listgetendings)
* [ListIndexExists](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listindexexists)
* [ListInsertAt](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listinsertat)
* [ListItemTrim](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listitemtrim)
* [ListLast](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listlast)
* [ListLen](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listlen)
* [ListMap](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listmap)
* [ListNone](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listnone)
* [ListPrepend](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listprepend)
* [ListQualify](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listqualify)
* [ListReduceRight](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listreduceright)
* [ListRemoveDuplicates](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listremoveduplicates)
* [ListRest](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listrest)
* [ListSetAt](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listsetat)
* [ListSome](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listsome)
* [ListSort](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listsort)
* [ListToArray](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listtoarray)
* [ListTrim](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listtrim)
* [ListValueCount](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listvaluecount)
* [ListValueCountNoCase](https://boxlang.ortusbooks.com/boxlang-language/reference/built-in-functions/list/listvaluecountnocase)