Monkeybread Software - MBS FileMaker Plugin: QuickList.MatchesPrefix

Topics All MacOS (Only) Windows (Only) Linux (Only, Not) iOS (Only, Not)
Components Crossplatform Mac & Win Server Client Old Deprecated Guides Examples Videos
New in version: 9.3 9.4 9.5 10.0 10.1 10.2 10.3 10.4 10.5 10.6 Statistic FMM Blog

QuickList.MatchesPrefix

Finds list entries which have a given prefix text.

Component	Version	macOS	Windows	Linux	Server	FileMaker iOS SDK
List	5.4	Yes	Yes	Yes	Yes	Yes

MBS( "QuickList.MatchesPrefix"; ListRef; Text { ; Flags } ) More

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.Free 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

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.Free 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

Finds list entries which have a given prefix text.
Comparison is case insensitive.

Examples

Finds list entries with same prefixes:

Set Variable [$list; Value:MBS( "QuickList.New"; "Hello¶World¶auto" )]
Set Variable [$matchesList; Value:MBS( "QuickList.MatchesPrefix"; $list; "w"; 0)]
Set Variable [$text; Value:MBS( "QuickList.GetList"; $list)]
Set Variable [$r; Value:MBS( "QuickList.Free"; $list )]
Show Custom Dialog ["result"; $text]

Find entries not matching in prefix:

Set Variable [$list; Value:MBS( "QuickList.New"; "Hello¶World¶auto" )]
Set Variable [$matchesList; Value:MBS( "QuickList.MatchesPrefix"; $list; "w"; 4)]
Set Variable [$text; Value:MBS( "QuickList.GetList"; $list)]
Set Variable [$r; Value:MBS( "QuickList.Free"; $list )]
Show Custom Dialog ["Result"; $text]

Blog Entries

Created 20th November 2015, last changed 30th December 2015

QuickList.MatchesPostfix - QuickList.MatchesSubString