QuickList.GetList

Queries the list as text.

Parameters

Parameter	Description	Example	Flags
ListRef	The reference to the list returned from QuickList.New function.	$List
NoReturnEnding	Pass 1 to have no extra newline character on the end of the returned list. Default is 0 to include one to easily concat lists.	1	Optional
Delimiter	The delimiter to use. Can be empty to have no delimiter. Common use is to pass "¶", ", " or "; ".	", "	Optional

Result

Returns text or error.

Description

Examples

Create a list and query it:

$listID = MBS( "QuickList.New"; "Hello¶World")
$list = MBS( "QuickList.GetList"; $listID)
$r = MBS("QuickList.Release"; $listID)

Try with delimiter:

Set Variable [$listID; Value:MBS( "QuickList.New"; "Hello¶World")]
Set Variable [$list1; Value:MBS( "QuickList.GetList"; $listID)]
Show Custom Dialog ["Result default"; $list1]
Set Variable [$list2; Value:MBS( "QuickList.GetList"; $listID; 0; "")]
Show Custom Dialog ["Result with empty delimiter"; $list2]
Set Variable [$list3; Value:MBS( "QuickList.GetList"; $listID; 0; " ")]
Show Custom Dialog ["Result with space delimiter"; $list3]
Set Variable [$r; Value:MBS("QuickList.Release"; $listID)]

Build a 10000 entry List:

Let ( [
q = MBS("QuickList.New");
// add 10000 entries
t = While ( [ i = 0 ] ; i < 10000 ; [ i = i + 1; r = MBS( "QuickList.AddValue"; q; "test " & i ) ] ; 0 );
// get as text
r = MBS("QuickList.GetList"; q);
// free memory
f = MBS("QuickList.Release"; q)
];
Length(r) & ¶ & r )

See also

• QuickList.PopFirst
• QuickList.Release
• QuickList.RemovePostfix
• QuickList.RemovePrefix
• QuickList.Reverse
• QuickList.Serialize
• QuickList.SetList
• QuickList.Shuffle
• QuickList.Sort
• QuickList.SortWith

Example Databases

• List/QuickList Test
• List/Sort Benchmark

Blog Entries

• MBS FileMaker Plugin, version 6.2pr4
• Evaluate vs. Script Trigger
• Quicklist - Fast lists for FileMaker

This function checks for a license.

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

QuickList.GetColumn - QuickList.GetValue