QuickList.Serialize
-------------------

Serialized a list as a text.

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

MBS( "QuickList.Serialize"; ListRef ) 

**MBS**( **"QuickList.Serialize";** /\* Serialized a list as a text. \*/  
**$ListRef**) /\* The reference to the list returned from [QuickList.New](QuickListNew.md) function.e.g. $List \*/ 

### Parameters

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

### Result

Returns text or error.

### Description

Serialized a list as a text.  
The dictionary content is stored in a base64 encoded string which the plugin function [List.Deserialize](ListDeserialize.md) and [QuickList.Deserialize](QuickListDeserialize.md) can read.  
Using this function allows to store a list in a text field or transmit it with [Socket](component_Socket.md) functions, [SerialPort](component_SerialPort.md) functions or by writing it to a file.  
### Examples

Create and save a list to restore it:

 Set Variable \[$list ; Value:MBS ( "[QuickList.New](QuickListNew.md)"; "Hello¶World¶1234¶Just a test!")\]  
Set Variable \[$text ; Value:MBS ("Quicklist.Serialize"; $list )\]  
Set Variable \[$SecondList ; Value:MBS ("[QuickList.Deserialize](QuickListDeserialize.md)"; $text )\]  
Show Custom Dialog \["List"; "Encoded: " &amp; $text &amp; ¶ &amp; ¶ &amp; "Decoded: " &amp; MBS ("[QuickList.GetList](QuickListGetList.md)"; $secondList )\]  
Set Variable \[$r ; Value:MBS ("[QuickList.Release](QuickListRelease.md)"; $list )\]  
Set Variable \[$r ; Value:MBS ("[QuickList.Release](QuickListRelease.md)"; $secondList )\]  
### See also

- [List.Deserialize](ListDeserialize.md)
- [List.Serialize](ListSerialize.md)
- [QuickList.Deserialize](QuickListDeserialize.md)
- [QuickList.GetList](QuickListGetList.md)
- [QuickList.GetValue](QuickListGetValue.md)
- [QuickList.New](QuickListNew.md)
- [QuickList.Release](QuickListRelease.md)
- [QuickList.SetValue](QuickListSetValue.md)

### Blog Entries

- [Data structures in FileMaker with MBS Plugins](https://www.mbsplugins.de/archive/2017-10-19/Data_structures_in_FileMaker_w/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 5.2pr6](https://www.mbsplugins.de/archive/2015-07-10/MBS_FileMaker_Plugin_version_5/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 6th July 2015 , last changed 14th December 2023

  
[QuickList.Reverse](QuickListReverse.md) - [QuickList.SetList](QuickListSetList.md)

[HTML Version](QuickListSerialize.shtml)