# LGF_MatrixCompare (FC / V3.0.1)

Autor: Siemens Digital Industry

## Kurzbeschreibung

Die Funktion vergleicht zwei gleich große Matrizen vom Datentyp `ARRAY[*,*] of LREAL`.

Sind beide Matrizen identisch, dann wird der Rückgabewert der Funktion auf TRUE geetzt.

Hinweis
  Beachten Sie, dass alle Eingangsmatrizen die gleiche untere und obere Grenze und somit die gleiche Anzahl an Spalten und Reihen haben müssen.

### Baustein Schnittstelle

| LGF_MatrixCompare (FC) |
--- | --- | ---
|  |  |  |  | Ret_Val |  |  | Bool
|  |  |  |  | error |  |  | Bool
|  |  |  |  | status |  |  | Word
Array[*, *] of LReal |  |  | matrix1 |  |  | Array[*, *] of LReal
Array[*, *] of LReal |  |  | matrix2 |  |  | Array[*, *] of LReal

### Output Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
Ret_Val | Bool | TRUE: Beide Matrizen sind identisch.
error | Bool | FALSE: Kein Fehler TRUE: Während der Ausführung des FB ist ein Fehler aufgetreten
status | Word | 16#0000-16#7FFF: Status des FB 16#8000-16#FFFF: Fehleridentifikation (siehe folgende Tabelle)

### In/Out Parameter

Bezeichner | Datentyp | Beschreibung
--- | --- | ---
matrix1 | Array[*, *] of LReal | Erste Matrix
matrix2 | Array[*, *] of LReal | Zweite Matrix

### Status & Error Meldungen

Code / Wert | Bezeichner / Beschreibung
--- | ---
16#0000 | STATUS_NO_ERROR Abarbeitung ohne Fehler beendet
16#8200 | ERR_MATR1_LOWBOUND_ROWS_MATR2_LOWBOUND_ROWS Error: Untere Grenzen Zeilen(Dim1) der Arrays von Matrix1 und Matrix2 sind unterschiedlich.
16#8201 | ERR_MATR1_LOWBOUND_COLUMNS_MATR2_LOWBOUND_COLUMNS Error: Untere Grenzen Spalten(Dim2) der Arrays von Matrix1 und Matrix2 sind unterschiedlich.
16#8202 | ERR_MATR1_UPPBOUND_ROWS_MATR2_UPPBOUND_ROWS Error: Obere Grenzen Zeilen(Dim1) der Arrays von Matrix1 und Matrix2 sind unterschiedlich.
16#8203 | ERR_MATR1_UPPBOUND_COLUMNS_MATR2_UPPBOUND_COLUMNS Error: Obere Grenzen Spalten(Dim2) der Arrays von Matrix1 und Matrix2 sind unterschiedlich.

## Änderungshistorie

Version & Datum | Änderungsbeschreibung
--- | ---
| 01.00.00 | Simatic Systems Support
| 13.11.2019 | First release
| 03.00.00 | Simatic Systems Support
| 23.04.2020 | Set version to V3.0.0, harmonize the version of the whole library
| 03.00.01 | Simatic Systems Support
| 02.02.2020 | Insert documentation