Matrix.Release
--------------

Frees the matrix object.

| Component | Version | macOS | Windows | Linux | Server | iOS SDK |
|---|---|---|---|---|---|---|
| [Matrix](component_Matrix.md) | [9.2](newinversion92.md) | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes | ✅ Yes |

MBS( "Matrix.Release"; MatrixRef ) 

**MBS**( **"Matrix.Release";** /\* Frees the matrix object. \*/  
**$MatrixRef**) /\* The matrix reference number.e.g. $matrix \*/ 

(old name: Matrix.Free)

### Parameters

| Parameter | Description | Example |
|---|---|---|
| MatrixRef | The matrix reference number. | $matrix |

### Result

Returns OK or error.

### Description

Frees the matrix object.  
Releases all memory used to store the matrix itself and the values.  
### Examples

Frees matrix:

 Set Variable \[ $r ; Value: MBS ("Matrix.Release"; $matrix ) \]  
### See also

- [MapView.Release](MapViewRelease.md)
- [Matrix.NewWithSQL](MatrixNewWithSQL.md)
- [Matrix.ReleaseAll](MatrixReleaseAll.md)
- [Matrix.Resize](MatrixResize.md)
- [Matrix.Rotate](MatrixRotate.md)
- [Matrix.SearchAndReplace](MatrixSearchAndReplace.md)
- [Matrix.SetRowName](MatrixSetRowName.md)
- [Matrix.SetValue](MatrixSetValue.md)
- [Matrix.SwapRows](MatrixSwapRows.md)
- [Mutex.Release](MutexRelease.md)

### Release notes

- **Version 10.5**
    - Added [Matrix.ReleaseAll](https://www.mbsplugins.eu/MatrixReleaseAll.shtml) and renamed [Matrix.Free](https://www.mbsplugins.eu/MatrixRelease.shtml) to [Matrix.Release](https://www.mbsplugins.eu/MatrixRelease.shtml).

### Example Databases

- [SQL in FileMaker/Insert or Update Tests](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/SQL%20in%20FileMaker/Insert%20or%20Update%20Tests.shtml#6ScriptAnchor_)
- [SQL to other databases/SQLite fun](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/SQL%20to%20other%20databases/SQLite%20fun.shtml#10ScriptAnchor_)
- [XL/XL Test](https://www.mbsplugins.eu/MBS-FileMaker-Plugin-Examples/XL/XL%20Test.shtml#4ScriptAnchor_)

### Blog Entries

- [MBS FileMaker Plugin 16.2 News](https://www.mbsplugins.de/archive/2026-05-20/MBS_FileMaker_Plugin_162_News/monkeybreadsoftware_blog_filemaker)
- [Introducing Matrix.MBS: Dynamic Function Calls with Matrix Parameters](https://www.mbsplugins.de/archive/2026-05-08/Introducing_MatrixMBS_Dynamic_/monkeybreadsoftware_blog_filemaker)
- [Import CSV with Matrix functions](https://www.mbsplugins.de/archive/2020-11-20/Import_CSV_with_Matrix_functio/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 10.5pr8](https://www.mbsplugins.de/archive/2020-11-09/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

### FileMaker Magazin

- [Ausgabe 4/2019, Seite 31](https://filemaker-magazin.de/neuigkeit/4053-Appetithappen-FMM_201904)

This function checks for a license.

Created 8th April 2019 , last changed 26th September 2023

  
[Matrix.NewWithSQL](MatrixNewWithSQL.md) - [Matrix.ReleaseAll](MatrixReleaseAll.md)

[HTML Version](MatrixRelease.shtml)