QuickList.Shuffle
-----------------

Shuffles the items in the list.

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

MBS( "QuickList.Shuffle"; List { ; ReturnNewList } ) 

**MBS**( **"QuickList.Shuffle";** /\* Shuffles the items in the list. \*/  
**$List**; /\* The list to work on. \*/   
**$ReturnNewList**) /\* Optional; Pass 1 to return result as new QuickList.   
This new list must be freed later using [QuickList.Release](QuickListRelease.md) function.   
Pass 0 (Default) to modify the list in the List1 parameter.e.g. 0 \*/ 

### Parameters

| Parameter | Description | Example | Flags |
|---|---|---|---|
| List | The list to work on. | $List |  |
| ReturnNewList | Pass 1 to return result as new QuickList.    This new list must be freed later using [QuickList.Release](QuickListRelease.md) function.    Pass 0 (Default) to modify the list in the List1 parameter. | 0 | Optional |

### Result

Returns list, OK or error.

### Description

Shuffles the items in the list.  
We use random number generator to swap items randomly and change the list.  
### Examples

Try shuffle:

 Set Variable \[ $listRef ; Value: MBS ("[QuickList.New](QuickListNew.md)"; "a¶b¶c¶d¶e¶f") \]   
\#   
Set Variable \[ $r ; Value: MBS ("QuickList.Shuffle"; $listRef ) \]   
Set Variable \[ $list ; Value: MBS ("[QuickList.GetList](QuickListGetList.md)"; $listRef ) \]   
Show Custom Dialog \[ "list shuffled" ; $list \]   
\#   
Set Variable \[ $r ; Value: MBS ("QuickList.Shuffle"; $listRef ) \]   
Set Variable \[ $list ; Value: MBS ("[QuickList.GetList](QuickListGetList.md)"; $listRef ) \]   
Show Custom Dialog \[ "list shuffled" ; $list \]   
\#   
Set Variable \[ $r ; Value: MBS ("[QuickList.Release](QuickListRelease.md)"; $listRef ) \]  
### See also

- [List.Shuffle](ListShuffle.md)
- [QuickList.GetList](QuickListGetList.md)
- [QuickList.New](QuickListNew.md)
- [QuickList.Release](QuickListRelease.md)
- [QuickList.SetValue](QuickListSetValue.md)

### Release notes

- **Version 14.0**
    - Added [List.Shuffle](https://www.mbsplugins.eu/ListShuffle.shtml) and [QuickList.Shuffle](https://www.mbsplugins.eu/QuickListShuffle.shtml) functions.

### Blog Entries

- [New in MBS FileMaker Plugin 14.0](https://www.mbsplugins.de/archive/2024-01-23/New_in_MBS_FileMaker_Plugin_14/monkeybreadsoftware_blog_filemaker)
- [Neues MBS Plugin 14.0 für Claris FileMaker](https://www.mbsplugins.de/archive/2024-01-16/Neues_MBS_Plugin_140_für_Clar/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin 14.0 for Claris FileMaker](https://www.mbsplugins.de/archive/2024-01-16/MBS_FileMaker_Plugin_140_for_C/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 13.6pr1](https://www.mbsplugins.de/archive/2023-12-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 8th November 2023 , last changed 14th December 2023

  
[QuickList.SetValue](QuickListSetValue.md) - [QuickList.Sort](QuickListSort.md)

[HTML Version](QuickListShuffle.shtml)