Components All New MacOS Windows Linux iOS
Examples Mac & Win Server Client Guides Statistic FMM Blog Deprecated Old

QuickList.MatchesPrefix

Finds list entries which have a given prefix text.

Component Version macOS Windows Linux Server 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.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

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.Release"; $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.Release"; $list )]
Show Custom Dialog ["Result"; $text]

See also

Blog Entries

This function checks for a license.

Created 20th November 2015, last changed 14th December 2023


QuickList.MatchesPostfix - QuickList.MatchesSubString