QuickList.IndexOfFirstValueMatching
-----------------------------------

Finds index of first value matching value.

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

MBS( "QuickList.IndexOfFirstValueMatching"; ListRef; Operator; Value { ; Mode; StartRow } ) 

**MBS**( **"QuickList.IndexOfFirstValueMatching";** /\* Finds index of first value matching value. \*/  
**$ListRef**; /\* The reference to the list returned from [QuickList.New](QuickListNew.md) function.e.g. $List \*/   
**$Operator**; /\* The compare operator.  
Can be =, !=, &lt;, &gt;, &lt;=, &gt;=, ≤, ≥, ≠, Prefix or Postfix.e.g. "≥" \*/   
**$Value**; /\* The value to compare.e.g. "Test" \*/   
**$Mode**; /\* Optional; Pass 1 for numeric comparison.  
Default is 0 for text comparison.e.g. 0 \*/   
**$StartRow**) /\* Optional; The row to start at.  
Default is 0.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| ListRef | The reference to the list returned from [QuickList.New](QuickListNew.md) function. | $List |  |
| Operator | The compare operator.   Can be =, !=, &lt;, &gt;, &lt;=, &gt;=, ≤, ≥, ≠, Prefix or Postfix. | "≥" |  |
| Value | The value to compare. | "Test" |  |
| Mode | Pass 1 for numeric comparison.   Default is 0 for text comparison. | 0 | Optional      Added in version **10.3**. |
| StartRow | The row to start at.   Default is 0. | 0 | Optional      Added in version **14.0**. |

### Result

Returns number or error.

### Description

Finds index of first value matching value.  
This uses text comparison!  
### Examples

Find index of first value ≥4:

 Let(\[  
list = MBS ( "[QuickList.New](QuickListNew.md)"; "1¶2¶3¶4");  
count = MBS ( "QuickList.IndexOfFirstValueMatching"; list; "≥"; 4 );  
r = MBS ("[QuickList.Release](QuickListRelease.md)"; list)\];  
count)  
### See also

- [List.IndexOfFirstValueMatching](ListIndexOfFirstValueMatching.md)
- [Matrix.IndexOfFirstValueMatching](MatrixIndexOfFirstValueMatching.md)
- [QuickList.New](QuickListNew.md)
- [QuickList.Release](QuickListRelease.md)

### Release notes

- **Version 10.4**
    - Added prefix/postfix operator for [List.IndexOfFirstValueMatching](https://www.mbsplugins.eu/ListIndexOfFirstValueMatching.shtml), [QuickList.IndexOfFirstValueMatching](https://www.mbsplugins.eu/QuickListIndexOfFirstValueMatching.shtml), [List.CountValuesMatching](https://www.mbsplugins.eu/ListCountValuesMatching.shtml) and [QuickList.CountValuesMatching](https://www.mbsplugins.eu/QuickListCountValuesMatching.shtml).
- **Version 10.3**
    - Added numeric mode for [List.CountValuesMatching](https://www.mbsplugins.eu/ListCountValuesMatching.shtml), [List.IndexOfFirstValueMatching](https://www.mbsplugins.eu/ListIndexOfFirstValueMatching.shtml), [QuickList.CountValuesMatching](https://www.mbsplugins.eu/QuickListCountValuesMatching.shtml) and [QuickList.IndexOfFirstValueMatching](https://www.mbsplugins.eu/QuickListIndexOfFirstValueMatching.shtml) functions.
- **Version 10.2**
    - Added [List.CountValuesMatching](https://www.mbsplugins.eu/ListCountValuesMatching.shtml), [List.IndexOfFirstValueMatching](https://www.mbsplugins.eu/ListIndexOfFirstValueMatching.shtml), [QuickList.CountValuesMatching](https://www.mbsplugins.eu/QuickListCountValuesMatching.shtml) and [QuickList.IndexOfFirstValueMatching](https://www.mbsplugins.eu/QuickListIndexOfFirstValueMatching.shtml) functions.

### Blog Entries

- [Data structures in MBS Plugin](https://www.mbsplugins.de/archive/2023-11-27/Data_structures_in_MBS_Plugin/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.4pr7](https://www.mbsplugins.de/archive/2020-09-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.3pr6](https://www.mbsplugins.de/archive/2020-06-25/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [News about the MBS FileMaker Plugin 10.2](https://www.mbsplugins.de/archive/2020-05-19/News_about_the_MBS_FileMaker_P/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.2pr2](https://www.mbsplugins.de/archive/2020-04-06/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 5th April 2020 , last changed 14th December 2023

  
[QuickList.HasValues](QuickListHasValues.md) - [QuickList.InsertValue](QuickListInsertValue.md)

[HTML Version](QuickListIndexOfFirstValueMatching.shtml)