Matrix.Append
-------------

Appends second matrix to first one.

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

MBS( "Matrix.Append"; Matrix1; Matrix2 ) 

**MBS**( **"Matrix.Append";** /\* Appends second matrix to first one. \*/  
**$Matrix1**; /\* The matrix reference number. \*/   
**$Matrix2**) /\* The matrix reference number. \*/ 

### Parameters

| Parameter | Description | Example |
|---|---|---|
| Matrix1 | The matrix reference number. | $matrix1 |
| Matrix2 | The matrix reference number. | $matrix2 |

### Result

Returns OK or error.

### Description

Appends second matrix to first one.  
Source and destination can be the same and then we duplicate all rows on the end.  
The width of both matrices should be the same, but doesn’t need to be.   
### Examples

Appends a matrix to another:

 Let(\[  
 // new matrix  
 matrix = MBS ("[Matrix.New](MatrixNew.md)"; 3; 4);  
 // add some content  
 r = MBS ( "[Matrix.SetRow](MatrixSetRow.md)"; matrix; 0; "00¶01¶02¶03" );  
 r = MBS ( "[Matrix.SetRow](MatrixSetRow.md)"; matrix; 1; "10¶11¶12¶13" );  
 r = MBS ( "[Matrix.SetRow](MatrixSetRow.md)"; matrix; 2; "20¶21¶22¶23" );  
 // creates a second matrix  
 matrix2 = MBS ("[Matrix.New](MatrixNew.md)"; 1; 4);  
 r = MBS ( "[Matrix.SetRow](MatrixSetRow.md)"; matrix2; 0; "a¶b¶c¶d" );  
 // copy content of first matrix to second  
 r = MBS ( "Matrix.Append"; matrix; matrix2 );  
 // output matrix to check  
 csv = MBS ("[Matrix.CSV](MatrixCSV.md)"; matrix)  
\]; csv)  
<small>  
Example result:   
00;01;02;03  
10;11;12;13  
20;21;22;23  
a;b;c;d</small>### See also

- [Matrix.CSV](MatrixCSV.md)
- [Matrix.New](MatrixNew.md)
- [Matrix.SetRow](MatrixSetRow.md)

### Release notes

- **Version 15.3**
    - Added [Matrix.Append](https://www.mbsplugins.eu/MatrixAppend.shtml) function.

### Blog Entries

- [MBS FileMaker Plugin 15.3 News](https://www.mbsplugins.de/archive/2025-07-29/MBS_FileMaker_Plugin_153_News/monkeybreadsoftware_blog_filemaker)
- [MBS FileMaker Plugin, version 15.3pr1](https://www.mbsplugins.de/archive/2025-06-01/MBS_FileMaker_Plugin_version_1/monkeybreadsoftware_blog_filemaker)

This function checks for a license.

Created 23th May 2025 , last changed 23th May 2025

  
[Matrix.AddRows](MatrixAddRows.md) - [Matrix.Avg](MatrixAvg.md)

[HTML Version](MatrixAppend.shtml)