QuickList.MatchesSubString

Finds list entries which contains a given text.

Parameters

Parameter	Description	Example	Flags
ListRef	The reference to the list returned from QuickList.New function.	$List
Text	The text to find.	"Hello"
Flags	Pass 1 to return result as new QuickList. This new list must be freed later using QuickList.Release function. Pass 0 (Default) to modify the list in the List1 parameter. Add 2 to split. This is only useful with first option together (so pass 3 for both). Matching entries will be in new list and non matching entries will stay in old list. Add 4 to reverse operation (NOT).	0	Optional

Result

Returns OK, list or error.

Description

Examples

Split a list matching substring:

Set Variable [$list; Value:MBS( "QuickList.New"; "Hello¶World¶auto" )]
Set Variable [$matchesList; Value:MBS( "QuickList.MatchesSubstring"; $list; "orl"; 3)]
Set Variable [$text1; Value:MBS( "QuickList.GetList"; $list)]
Set Variable [$text2; Value:MBS( "QuickList.GetList"; $matchesList)]
Set Variable [$r; Value:MBS( "QuickList.Release"; $list )]
Set Variable [$r; Value:MBS( "QuickList.Release"; $matchesList )]
Show Custom Dialog ["Result"; "Matches: " & $text1 & ¶ & "Others: " & $text2]

See also

• List.MatchesSubString
• QuickList.GetList
• QuickList.MatchesPostfix
• QuickList.New
• QuickList.Release

Release notes

• Version 11.0
  • Changed QuickList.MatchesSubString to use caseless comparison on Windows and Linux and not just on macOS/iOS.

Blog Entries

• MBS FileMaker Plugin, version 10.6pr1
• Comparing Base Elements Plugin to MBS FileMaker Plugin
• MBS FileMaker Plugin, version 6.0pr7
• MBS FileMaker Plugin, version 6.0pr5

This function checks for a license.

Created 30th December 2015, last changed 14th December 2023

QuickList.MatchesPrefix - QuickList.New