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: 10.0   10.1   10.2   10.3   10.4   10.5   11.0   11.1   11.2   11.3    Statistic    FMM    Blog  

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

FileMaker Magazin

Created 21st September 2014, last changed 20th June 2021


QuickList.MatchesSubString - QuickList.Not

Feedback: Report problem or ask question.




Links
MBS FileMaker tutorial videos

Start Chat