Kurz-Information

Name	`FIND`
→POE-Typ	→Funktion
Kategorie	IEC-Baustein, String
Konform zur →IEC-Norm	derzeit eingeschränkt (IEC fordert Datentyp `ANY_STRING` für den Eingang `IN1` und daher auch diesen Datentyp: `WSTRING`. Dieser Datentyp wird derzeit für den Baustein nicht unterstützt. IEC fordert Datentyp `ANY_CHARS` für den Eingang `IN2` und daher auch diese Datentypen: `WSTRING` , `CHAR`, `WCHAR`. Diese Datentypen werden derzeit für den Baustein nicht unterstützt.)
Grafische Schnittstelle
Verfügbar ab	Version 1.30.0 (für logi.CAD 3)

Funktionalität

Der Baustein bestimmt die erste Position, an der ein String innerhalb eines anderen Strings beginnt. Dabei wird die Groß- und Kleinschreibung beachtet.

Am Eingang IN1 geben Sie eine Zeichenkette ein (= 1. String) , welche durchsucht werden soll, und am Eingang IN2 den Such-String (= 2. String). Falls der Such-String nicht im 1. String enthalten ist, liefert der Baustein den Wert 0 . Falls nach einer leeren Zeichenfolge gesucht wird, liefert der Baustein den Wert 1 .

logi.CAD 3 bestimmt die Positionen von Zeichen in einem String so: 1, 2, ..., n. Dabei entspricht 1 dem Zeichen ganz links im String und n der Länge des Strings.
Kombinationen von 3 Zeichen, beginnend mit dem Dollar-Zeichen ($) und gefolgt von 2 Hexadezimal-Ziffern, gelten als ein einziges Zeichen. Beispiel: Der String '$B15' (entspricht '±5') besteht somit aus 2 Zeichen. Weitere Beispiele für diese Kombinationen finden Sie unter →Zeichenfolge-Literal.

Eingänge, Ergebniswert

	Bezeichner	→Datentyp	Beschreibung
Eingänge:	`IN1`	`STRING`	1. Eingangswert (= String, in dem gesucht wird)
	`IN2`	`STRING`	2. Eingangswert (= String, nach dem gesucht wird)
Ergebniswert:	–	`USINT`, `UINT`, `UDINT`, `ULINT`, `SINT`, `INT`, `DINT` oder `LINT` (entspricht dem →allgemeinen Datentyp `ANY_INT`)

Der Eingang EN und der Ausgang ENO sind für den →Aufruf des Bausteins verfügbar. Siehe "Ausführungssteuerung: EN, ENO" für Informationen zum Eingang EN und zum Ausgang ENO.

Beispiel für Verwendung im ST-Editor

PROGRAM Test
	VAR
		result1, result2, result3, result4, result5, result6, result7 : INT;
		str6 : STRING[1];
	END_VAR
	result1 := FIND(IN1 := 'ASTRING_NEWSTRING', IN2 := 'STRING');     (* The variable 'result1' evaluates to '2'. *)
	result2 := FIND(IN1 := 'ASTRING_NEWSTRING', IN2 := 'String');     (* The variable 'result2' evaluates to '0'. Reason: The strings differ regarding their case sensitivity. *)
	result3 := FIND(IN1 := 'ASTRING_NEWSTRING', IN2 := 'NEW');        (* The variable 'result3' evaluates to '9'. *)
	result4 := FIND(IN1 := 'ASTRING_NEWSTRING', IN2 := 'X');          (* The variable 'result4' evaluates to '0'. *)
	result5 := FIND(IN1 := '$B15', IN2 := '5');                       (* The variable 'result5' evaluates to '2'. *)
	result6 := FIND(IN1 := 'ASTRING', IN2 := str6);                   (* The variable 'result6' evaluates to '1'. Reason: An empty string is searched for. *)
	result7 := FIND(IN1 := 'ASTRING', IN2 := '$00');                  (* The variable 'result7' evaluates to '1'. Reason: An empty string is searched for because '$00' is an empty string. *)
END_PROGRAM

Bei der Erstellung Ihrer Anwendung im ST-Editor erstellen Sie den Aufruf eines Bausteins, indem Sie den laut Syntax erforderlichen Text eintippen oder die Inhaltshilfe verwenden.