Die Bibliothek SysLibStr.
lib
Die Bibliothek [Link]
Diese Bibliothek bietet Funktionen für den Umgang mit Strings. Wenn das Zielsystem die
Funktionalität beinhaltet, können folgende Bibliotheksfunktionen verwendet werden, um Strings
zu vergleichen:
• SysStrCmp
• SysStrCmpI
• SysStrCmpN
• SysStrCmpNI
zu kopieren:
• SysStrCpy
oder die Stringlänge zu ermitteln:
• SysStrLen
Die Abarbeitung der Funktionen erfolgt synchron.
SysStrCmp
Diese Funktion vom Typ DINT führt einen lexicographischen Vergleich zweier Strings durch und liefert
eines der folgenden Ergebnisse:
Rückgabewert < 0 String1 kleiner als String2
Rückgabewert = 0 String1 = String2
Rückgabewert > 0 String1 größer als String2
Input-Variable Datentyp Beschreibung
dwString1 STRING erster String
dwString2 STRING zweiter String
SysStrCmpI
Diese Funktion vom Typ DINT überprüft, ob zwei Strings identisch sind und liefert eines der folgenden
Ergebnisse:
Rückgabewert < 0 String1 kleiner als String2
Rückgabewert = 0 String1 = String2
Rückgabewert > 0 String1 größer als String2
Input-Variable Datentyp Beschreibung
dwString1 STRING erster String
dwString2 STRING zweiter String
3S – Smart Software Solutions GmbH / 05.01.2005/ CoDeSys V2.3 1
Die Bibliothek [Link]
SysStrCmpN
Diese Funktion vom Typ DINT vergleicht die Größe zweier Strings, wobei eine definierte Stellenzahl
ab dem Stringanfang betrachtet wird. Die Funktion liefert eines der folgenden Ergebnisse:
Rückgabewert < 0 String1 kleiner als String2
Rückgabewert = 0 String1 = String2
Rückgabewert > 0 String1 größer als String2
Input-Variable Datentyp Beschreibung
sString1 STRING erster String
sString2 STRING zweiter String
diChars DINT Anzahl der Stellen, für die von Stringbeginn an gezählt, die
Größe der Strings verglichen werden soll
SysStrCmpNI
Diese Funktion vom Typ DINT vergleicht, ob die Anfangsbereiche zweier Strings, deren Stellenzahl
vorgegeben wird, identisch sind. Als Rückgabewert erhält man
Rückgabewert < 0 String1 kleiner als String2
Rückgabewert = 0 String1 = String2
Rückgabewert > 0 String1 größer als String2
Input-Variable Datentyp Beschreibung
sString1 STRING erster String
sString2 STRING zweiter String
diChars DINT Anzahl der Stellen, für die von Stringbeginn an gezählt, geprüft
wird, ob der Inhalt bei beiden Strings identisch ist
SysStrCpy
Diese Funktion vom Typ DWORD kopiert einen String (Str1) auf einen anderen (Str2). Als
Rückgabewert erhölt man einen Pointer auf den Quell-String Str1.
Input-Variable Datentyp Beschreibung
sString1 STRING String, auf den kopiert werden soll (Ziel)
sString2 STRING String, der kopiert werden soll (Quelle)
SysStrLen
Diese Funktion vom Typ DINT ermittelt die Länge eines Strings. Als Rückgabewert erhält man die
Anzahl der Stellen, wobei "terminal NULL" nicht mitgezählt wird.
Input-Variable Datentyp Beschreibung
sString1 STRING String, dessen Länge geprüft werden soll
2 3S – Smart Software Solutions GmbH / 05.01.2005 / CoDeSys V2.3