List.Find
---------

Finds an entry in the list.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [List](component_List.md) | [11.1](newinversion111.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "List.Find"; List; Value { ; ignoreCase } ) 

**MBS**( **"List.Find";** /\* Finds an entry in the list. \*/  
**$List**; /\* The list to process.e.g. "Hello" ¶ "" ¶ "World" \*/   
**$Value**; /\* The value to look for.e.g. "World" \*/   
**$ignoreCase**) /\* Optional; Boolean to define whether to ignore case.  
Default is 0 for case sensitive compare.  
Pass 1 for case insensitive compare.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| List | The list to process. | "Hello" ¶ "" ¶ "World" |  |
| Value | The value to look for. | "World" |  |
| ignoreCase | Boolean to define whether to ignore case.   Default is 0 for case sensitive compare.   Pass 1 for case insensitive compare. | 0 | Optional |

### Result

Returns index or error.

### Description

Finds an entry in the list.  
Returns -1 if item is not found.  
The index is zero based.  
### Examples

Look for World:

 MBS ( "List.Find"; "Hello¶World¶Test"; "World")  
<small>  
Example result: 1</small>Look for world:

 MBS ( "List.Find"; "Hello¶World¶Test"; "world"; 1)  
<small>  
Example result: 1</small>### See also

- [List.And](ListAnd.md)
- [List.FindDuplicateItems](ListFindDuplicateItems.md)
- [List.FindEquals](ListFindEquals.md)
- [List.FindUnequals](ListFindUnequals.md)
- [QuickList.FindDuplicateItems](QuickListFindDuplicateItems.md)

### Release notes

- **Version 14.0**
    - Added CaseSensitive flag for [List.FindDuplicateItems](https://www.mbsplugins.eu/ListFindDuplicateItems.shtml), [List.HasDuplicateItems](https://www.mbsplugins.eu/ListHasDuplicateItems.shtml), [List.RemoveDuplicateItems](https://www.mbsplugins.eu/ListRemoveDuplicateItems.shtml), [QuickList.FindDuplicateItems](https://www.mbsplugins.eu/QuickListFindDuplicateItems.shtml), [QuickList.HasDuplicateItems](https://www.mbsplugins.eu/QuickListHasDuplicateItems.shtml), [QuickList.RemoveDuplicateItems](https://www.mbsplugins.eu/QuickListRemoveDuplicateItems.shtml).
- **Version 11.1**
    - Added [List.Find](https://www.mbsplugins.eu/ListFind.shtml) and [QuickList.Find](https://www.mbsplugins.eu/QuickListFind.shtml) functions.
- **Version 10.5**
    - Added [List.FindDuplicateItems](https://www.mbsplugins.eu/ListFindDuplicateItems.shtml) and [QuickList.FindDuplicateItems](https://www.mbsplugins.eu/QuickListFindDuplicateItems.shtml) functions.
- **Version 7.3**
    - Added parameter for [QuickList.FindUnequals](http://www.mbsplugins.eu/QuickListFindUnequals.shtml) and [List.FindUnequals](http://www.mbsplugins.eu/ListFindUnequals.shtml) to only return items from first list.

### Blog Entries

- [MBS FileMaker Plugin 11.1](https://www.mbsplugins.de/archive/2021-03-16/MBS_FileMaker_Plugin_111/monkeybreadsoftware_blog_filemaker)
- [Neues MBS FileMaker Plugin 11.1](https://www.mbsplugins.de/archive/2021-03-09/Neues_MBS_FileMaker_Plugin_111/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 11.1](https://www.mbsplugins.de/archive/2021-03-09/MBS_FileMaker_Plugin_111/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 11.1pr6](https://www.mbsplugins.de/archive/2021-02-24/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 22nd February 2021 , last changed 7th September 2022

  
[List.Deserialize](ListDeserialize.md) - [List.FindDuplicateItems](ListFindDuplicateItems.md)

[HTML Version](ListFind.shtml)