QuickList.AddMultiValue

Adds a value or list to the list.

Parameters

Parameter	Description	Example	Flags
ListRef	The reference to the list returned from QuickList.New function.	$List
Text	The text to add. Can be a list itself.	"Hello"
Count	The number of times to add the value/list. Default is 0.	5
Separator	Available in MBS FileMaker Plugin 8.5 or newer. 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

Result

Returns OK or error.

Description

Examples

Create a list:

Let ( [
  q = MBS( "QuickList.New" );
  r = MBS( "QuickList.AddValue"; q; "First" );
  r = MBS( "QuickList.AddMultiValue"; q; "Middle"; 10 );
  r = MBS( "QuickList.AddValue"; q; "Last" );
  list = MBS("QuickList.GetList"; q);
  r = MBS( "QuickList.Release"; q )
]; list )

Example result:
First
Middle
Middle
Middle
Middle
Middle
Middle
Middle
Middle
Middle
Middle
Last

Create list from list:

Let ( [
  q = MBS( "QuickList.New" );
  r = MBS( "QuickList.AddMultiValue"; q; "Hello¶World"; 3 );
  list = MBS("QuickList.GetList"; q);
  r = MBS( "QuickList.Release"; q )
]; list )

Example result:
Hello
World
Hello
World
Hello
World

See also

• List.AddValue
• QuickList.AddValue
• QuickList.GetList
• QuickList.New
• QuickList.Release

Release notes

• Version 8.5
  • Added separator parameter for QuickList.AddList and QuickList.AddMultiValue.
• Version 7.2
  • Added QuickList.AddMultiValue function.

Blog Entries

• MBS FileMaker Plugin, version 8.5pr1
• MBS FileMaker Plugin, version 7.2pr1

This function checks for a license.

Created 15th March 2017, last changed 14th December 2023

QuickList.AddList - QuickList.AddPostfix