F_BA_ByteCmp

Die Funktion F_BA_ByteCmp vom Rückgabetyp DINT vergleicht den Inhalt eines Speicherbereiches in Byte-Schritten mit einem Vergleichs-Byte nCompare.

Sobald innerhalb des Speicherbereichs ein Byte gefunden wird, welches vom Wert her kleiner ist als das Vergleich Byte, bricht die Funktion ihren Vergleich ab und nimmt den Rückgabewert "-1" an. Wird ein Byte gefunden, welches größer ist als das Vergleichsbyte, so bricht die Funktion ebenfalls ab und nimmt den Rückgabewert "1" an. Wird hingegen kein Unterschied gefunden, d.h. alle Bytes des zu untersuchenden Speicherbereichs sind identisch mit dem Vergleichsbyte, so nimmt die Funktion bei Beendigung des Vergleiches den Wert "0" an.

Die Eingangsvariable pValue markiert den Beginn des Speicherbereiches, die Variable nSize die Länge.

Bei einer fehlerhaften Eingabe, d.h. pValue = 0 oder nSize = 0 wird die Funktion ebenfalls sofort abgebrochen und nimmt als Rückgabewert die "-1" an.

Syntax

FUNCTION F_BA_ByteCmp : DINT
VAR_INPUT
  pValue    : PVOID;
  nSize     : UXINT;
  nCompare  : BYTE;
END_VAR

Eingänge