QuickList.RegExMatch
--------------------

Matches a list against a pattern.

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

MBS( "QuickList.RegExMatch"; ListRef; Pattern; CompilerOptions; ExecuteOptions { ; ReturnNewList } ) 

**MBS**( **"QuickList.RegExMatch";** /\* Matches a list against a pattern. \*/  
**$ListRef**; /\* The reference to the list returned from [QuickList.New](QuickListNew.md) function.e.g. $List \*/   
**$Pattern**; /\* The pattern to use.e.g. "H(.\*)" \*/   
**$CompilerOptions**; /\* A number for the options to use. e.g. 1 for case insensitive or 512 for ungreedy.e.g. 512+1 \*/   
**$ExecuteOptions**; /\* The options for executing.e.g. 0 \*/   
**$ReturnNewList**) /\* Optional; Pass 1 to return result as new QuickList.   
This new list must be freed later using [QuickList.Release](QuickListRelease.md) function. Pass 0 (Default) to modify the list in the List1 parameter.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| ListRef | The reference to the list returned from [QuickList.New](QuickListNew.md) function. | $List |  |
| Pattern | The pattern to use. | "H(.\*)" |  |
| CompilerOptions | A number for the options to use. e.g. 1 for case insensitive or 512 for ungreedy. | 512+1 |  |
| ExecuteOptions | The options for executing. | 0 |  |
| ReturnNewList | Pass 1 to return result as new QuickList.    This new list must be freed later using [QuickList.Release](QuickListRelease.md) function. Pass 0 (Default) to modify the list in the List1 parameter. | 0 | Optional |

### Result

Returns list or error.

### Description

Matches a list against a pattern.  
This compiles the pattern, executes it and looks if we have a match or not for each list item.  
Returns the list items which match.  
### See also

- [QuickList.BestMatch](QuickListBestMatch.md)
- [QuickList.New](QuickListNew.md)
- [QuickList.Release](QuickListRelease.md)

### Release notes

- **Version 15.1**
    - Improved [List.RegExMatch](https://www.mbsplugins.eu/ListRegExMatch.shtml) and [QuickList.RegExMatch](https://www.mbsplugins.eu/QuickListRegExMatch.shtml) to take options in text form in addition to integers.

### Blog Entries

- [MBS FileMaker Plugin, version 15.1pr2](https://www.mbsplugins.de/archive/2025-02-06/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)
- [Data structures in FileMaker with MBS Plugins](https://www.mbsplugins.de/archive/2017-10-19/Data_structures_in_FileMaker_w/monkeybreadsoftware_blog_filemaker)
- [MBS Filemaker Plugin, version 4.4pr9](https://www.mbsplugins.de/archive/2014-11-05/MBS_Filemaker_Plugin_version_4/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 2nd November 2014 , last changed 14th December 2023

  
[QuickList.Push](QuickListPush.md) - [QuickList.Release](QuickListRelease.md)

[HTML Version](QuickListRegExMatch.shtml)