QuickList.AddMultiValue
-----------------------

Adds a value or list to the list.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [List](component_List.md) | [7.2](newinversion72.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "QuickList.AddMultiValue"; ListRef; Text; Count { ; Separator } ) 

**MBS**( **"QuickList.AddMultiValue";** /\* Adds a value or list to the list. \*/  
**$ListRef**; /\* The reference to the list returned from [QuickList.New](QuickListNew.md) function.e.g. $List \*/   
**$Text**; /\* The text to add.  
Can be a list itself.e.g. "Hello" \*/   
**$Count**; /\* The number of times to add the value/list.  
Default is 0.e.g. 5 \*/   
**$Separator**) /\* Optional; 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.e.g. "|" \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| ListRef | The reference to the list returned from [QuickList.New](QuickListNew.md) 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 | 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      Added in version **8.5**. |

### Result

Returns OK or error.

### Description

Adds a value or list to the list.  
### Examples

Create a list:

 Let ( \[  
 q = MBS ( "[QuickList.New](QuickListNew.md)" );  
 r = MBS ( "[QuickList.AddValue](QuickListAddValue.md)"; q; "First" );  
 r = MBS ( "QuickList.AddMultiValue"; q; "Middle"; 10 );  
 r = MBS ( "[QuickList.AddValue](QuickListAddValue.md)"; q; "Last" );  
 list = MBS ("[QuickList.GetList](QuickListGetList.md)"; q);  
 r = MBS ( "[QuickList.Release](QuickListRelease.md)"; q )  
\]; list )  
<small>  
Example result:   
First  
Middle  
Middle  
Middle  
Middle  
Middle  
Middle  
Middle  
Middle  
Middle  
Middle  
Last</small>Create list from list:

 Let ( \[  
 q = MBS ( "[QuickList.New](QuickListNew.md)" );  
 r = MBS ( "QuickList.AddMultiValue"; q; "Hello¶World"; 3 );  
 list = MBS ("[QuickList.GetList](QuickListGetList.md)"; q);  
 r = MBS ( "[QuickList.Release](QuickListRelease.md)"; q )  
\]; list )  
<small>  
Example result:   
Hello  
World  
Hello  
World  
Hello  
World</small>### See also

- [List.AddValue](ListAddValue.md)
- [QuickList.AddValue](QuickListAddValue.md)
- [QuickList.GetList](QuickListGetList.md)
- [QuickList.New](QuickListNew.md)
- [QuickList.Release](QuickListRelease.md)

### Release notes

- **Version 8.5**
    - Added separator parameter for [QuickList.AddList](http://www.mbsplugins.eu/QuickListAddList.shtml) and [QuickList.AddMultiValue](http://www.mbsplugins.eu/QuickListAddMultiValue.shtml).
- **Version 7.2**
    - Added [QuickList.AddMultiValue](http://www.mbsplugins.eu/QuickListAddMultiValue.shtml) function.

### Blog Entries

- [MBS FileMaker Plugin, version 8.5pr1](https://www.mbsplugins.de/archive/2018-10-02/MBS_FileMaker_Plugin_version_8/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 7.2pr1](https://www.mbsplugins.de/archive/2017-04-03/MBS_FileMaker_Plugin_version_7/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

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

  
[QuickList.AddList](QuickListAddList.md) - [QuickList.AddPostfix](QuickListAddPostfix.md)

[HTML Version](QuickListAddMultiValue.shtml)