String nach Token durchsuchen - Funktion

Leere Token erlaubt? ermittelt, ob die Funktion ein Token erkennt, wenn es mehrere aufeinander folgende Trennzeichen findet.

Wenn Leere Token erlaubt? FALSE ist (Standard), können zwei Token im Eingangs-String von mehreren nebeneinander liegenden Trennzeichen getrennt sein. Wenn Leere Token erlaubt? TRUE ist, wird zwischen jedem Paar nebeneinander liegender Trennzeichen ein leerer Token-String ausgegeben.

Eingangs-String ist der nach Token zu durchsuchende String.

Offset ist die Stelle in Eingabe-String, an der der Suchvorgang beginnen soll.

Die Standardeinstellung lautet 0. Damit beginnt die Suche am Anfang des Strings.

Operatoren ist ein Array von Strings, die als Token betrachtet werden, wenn sie in Eingabe-String auftreten, auch wenn sie nicht von Trennzeichen umgeben sind.

Wenn ein Teil eines Eingabe-Strings mehr als einem definierten Operatoren entspricht, wird als Token die längste Übereinstimmung ausgewählt. Wenn zum Beispiel >, = und >= definierte Operatoren sind, gibt der Eingangs-String 4>=0 den String >= als den nächsten Token-String mit dem Offset 1 aus.

Ein String in Operatoren kann folgende speziellen Formatcodes enthalten, die zur Suche von ganzen Zahlen als einzelne Token verwendet werden können:

%d	ganze Dezimalzahl finden
%o	ganze Oktalzahl finden
%x	ganze Hexadezimalzahl finden
%b	ganze Binärzahl finden
%e,%f,%g	Fließkommazahl oder reelle Zahl in wissenschaftlicher Notation finden
%%	Einzelnes %-Zeichen suchen

Trennzeichen ist ein Array aus Strings, die als Trennzeichen zwischen den Token dienen.

Strings in Trennzeichen werden nicht als Token ausgegeben, sondern sie trennen nebeneinander liegende Token. Die Standardtrennzeichen sind folgende nicht darstellbare Zeichen: Leerzeichen, Tabulator, Zeilenvorschub und Wagenrücklauf.

Cache für Daten verwenden? ist ein zusätzlicher erweiterter Eingang. Auch wenn dieser Eingang offen ist, funktioniert Token-String ordnungsgemäß.

Mit Cache für Daten verwenden? kann die Leistung beim Analysieren von Strings erheblich verbessert werden. Wenn Sie Token-String zum ersten Mal ausführen, setzen Sie den Parameter Cache für Daten verwenden? auf FALSE und für jedes weitere Ausführen auf TRUE, solange sich Operatoren und Trennzeichen nicht geändert haben. Wenn sich Operatoren und Trennzeichen während der Schleifenausführung nicht ändern, kann auch mit Schieberegistern mit dem konstanten Wert FALSE am Eingang und dem konstanten Wert TRUE am Ausgang für einen korrekten Ablauf gesorgt werden. Wenn der Parameter Cache für Daten verwenden? TRUE ist und sich Operatoren oder Trennzeichen während der letzten Ausführung geändert haben, kann es zur falschen Ausgabe von Tokens kommen. Wenn weder Operatoren noch Trennzeichen mit Blockdiagramm-Konstanten verbunden sind, kann auch eine optimale Verarbeitungsgeschwindigkeit erreicht werden, wenn der Parameter Cache für Daten verwenden? offen bleibt.

String (Ausgang) ist mit String (Eingang) identisch.

Offset nach Token ist der Offset in Eingabe-String unmittelbar nach dem zuletzt gefundenen Token und einem beliebigen Trennzeichen.

Ein eventuell nachfolgender Suchvorgang am selben Eingabe-String sollte an diesem Offset beginnen. Wenn der Offset kleiner als 0 oder größer als die Anzahl der Zeichen in Eingabe-String ist oder wenn das Ende des Strings erreicht wurde, ist Offset nach Token gleich –1.

Token-String ist das angepasste Token. Hierbei kann es sich um einen String aus Operatoren oder eine beliebige Zeichenkette zwischen Trennzeichen im Eingabe-String handeln.

Token-Index ist der Index von Token-String in Operatoren, wenn Token-String einem String in Operatoren entspricht.

Wenn Token-String ein anderer String ist, gibt Token-Index –1 aus. Wenn das Ende von Eingabe-String erreicht wurde, ohne gültige Operatoren zu finden, gibt Token-Index –2 aus.