FC_GetMatrixElement

FC_GetMatrixElement - Allgemeine Informationen

Übersicht

Typ	Funktion
Verfügbar ab:	V1.0.3.0
Versionen:	Aktuelle Version

Aufgabe

Lesen des Elements einer Matrix.

Beschreibung

Liefert das Matrixelement zurück, das in Zeile i_diRow und Spalte i_diCol einer Matrix steht. Der Zeiger i_plrMatrixStart muss auf den Beginn des Speicherbereichs zeigen, in dem die Matrix abgelegt ist. i_diNumCols muss die Anzahl der Spalten in der Matrix enthalten. i_diRow und i_diCol beginnen beide bei 0.

Schnittstelle

Eingang	Datentyp	Beschreibung
i_plrMatrixStart	POINTER TO LREAL	Zeiger auf die Startadresse der zu behandelnden Matrix.
i_diNumCols	DINT	Anzahl der Spalten, die in der Matrix enthalten sind.
i_diRow	DINT	Die Zeile, in der sich das zu lesende Matrixelement befindet.
i_diCol	DINT	Die Spalte, in der sich das zu lesende Matrixelement befindet.

Ausgang	Datentyp	Beschreibung
q_etDiag	GD.ET_Diag	Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose. Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung.
q_etDiagExt	ET_DiagExt	POU-spezifischer, diagnosebezogener Ausgang. q_etDiag = ET_Diag.Ok -> Statusmeldung q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

Ausgang

Datentyp

Beschreibung

q_etDiag

GD.ET_Diag

Allgemeingültige, bibliotheksunabhängige Aussage zur Diagnose.

Ein Wert ungleich ET_Diag.Ok entspricht einer Diagnosemeldung.

q_etDiagExt

ET_DiagExt

POU-spezifischer, diagnosebezogener Ausgang.

q_etDiag = ET_Diag.Ok -> Statusmeldung

q_etDiag <> ET_Diag.Ok -> Diagnosemeldung

Rückgabewert

Datentyp	Beschreibung
LREAL	Wert des zu lesenden Matrixelements

Diagnosemeldungen

q_etDiag	q_etDiagExt	Enumerationswert	Beschreibung
OK	Ok	0	OK

Enumerationsname:	Ok
Enumerationswert:	0
Beschreibung:	OK

Das Matrixelement wurde erfolgreich ausgelesen.