QuickList.AddValue
------------------

Adds a value to the list.

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

MBS( "QuickList.AddValue"; ListRef; Text ) 

**MBS**( **"QuickList.AddValue";** /\* Adds a value to the list. \*/  
**$ListRef**; /\* The reference to the list returned from [QuickList.New](QuickListNew.md) function.e.g. $List \*/   
**$Text**) /\* The text to add.e.g. "Hello" \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| ListRef | The reference to the list returned from [QuickList.New](QuickListNew.md) function. | $List |
| Text | The text to add. | "Hello" |

### Result

Returns OK or error.

### Description

Adds a value to the list.  
Building list via plugin can be much faster than building using FileMaker internal functions.  
### Examples

Add items to a list:

 $listID = MBS ( "[QuickList.New](QuickListNew.md)"; "Hello¶World")  
$r = MBS ( "QuickList.AddValue"; $listID ; "1234" )  
$r = MBS ( "QuickList.AddValue"; $listID ; "5678" )  
$list = MBS ( "[QuickList.GetList](QuickListGetList.md)"; $listID )  
$r = MBS ("[QuickList.Release](QuickListRelease.md)"; $listID )  
### See also

- [List.AddValue](ListAddValue.md)
- [QuickList.AddList](QuickListAddList.md)
- [QuickList.AndColumn](QuickListAndColumn.md)
- [QuickList.GetList](QuickListGetList.md)
- [QuickList.GetValue](QuickListGetValue.md)
- [QuickList.HasValue](QuickListHasValue.md)
- [QuickList.InsertValue](QuickListInsertValue.md)
- [QuickList.JoinJSON](QuickListJoinJSON.md)
- [QuickList.New](QuickListNew.md)
- [QuickList.SetValue](QuickListSetValue.md)

### Example Databases

- [DynaPDF/Invoice/Invoice](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/DynaPDF/Invoice/Invoice.shtml#3ScriptAnchor_)
- [List/QuickList Test](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/List/QuickList%20Test.shtml#2ScriptAnchor_)
- [List/Sort Benchmark](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/List/Sort%20Benchmark.shtml#10ScriptAnchor_)

### Blog Entries

- [QuickList.JSONArray vs. QuickList.JoinJSON](https://www.mbsplugins.de/archive/2024-08-09/QuickListJSONArray_vs_QuickLis/monkeybreadsoftware_blog_filemaker)
- [Data structures in MBS Plugin](https://www.mbsplugins.de/archive/2023-11-27/Data_structures_in_MBS_Plugin/monkeybreadsoftware_blog_filemaker)
- [Quicklist - Fast lists for FileMaker](https://www.mbsplugins.de/archive/2014-09-29/Quicklist_-_Fast_lists_for_Fil/monkeybreadsoftware_blog_filemaker)

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

  
[QuickList.AddSQL](QuickListAddSQL.md) - [QuickList.And](QuickListAnd.md)

[HTML Version](QuickListAddValue.shtml)