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

QuickList.New

Creates a new list.

Component Version macOS Windows Linux Server iOS SDK
List 4.4 ✅ Yes ✅ Yes ✅ Yes ✅ Yes ✅ Yes
MBS( "QuickList.New" { ; Text; Separator; RefNum } )   More

Parameters

Parameter Description Example Flags
Text Initial list content. "Hello¶World¶Test" Optional
Separator The separator to use.
Can be ASCII character number (e.g. 9 for tab) or a text where we use first character as separator.
Default is newline.		 "|" Optional
RefNum The desired reference number.
Leave empty for default.		 "IDs" Optional

Result

Returns reference number or error.

Description

Creates a new list.
You can provide whatever separator you need. Default is new line characters. But works also fine with comma, semicolon or tab characters.
Please use QuickList.Release to release the list later.
QuickList reference numbers are starting at 12000 and counting up for each new list.

QuickLists can have multiple million of entries without problems. Just be aware of FileMaker's standard loop/recursion limit of 50000, which can be raised with SetRecursion function.

Examples

Creates new list:

MBS( "QuickList.New"; "Hello¶World¶Test" )

Create list with | as separator:

MBS("QuickList.New"; "Hello|World"; "|")

Parse with newline as separator:

MBS("QuickList.GetList"; MBS( "QuickList.New"; "1¶2" & Char(10) & "3" & Char(13) & "4" ))
# accepts CR and LF as delimiter.

See also

Release notes

  • Version 8.1
  • Version 7.1
    • Fixed QuickList.New to handle empty element on the end correctly.

Example Databases

Blog Entries

This function checks for a license.

Created 21st September 2014, last changed 14th December 2023


QuickList.MatchesSubString - QuickList.Not