F_LEFT

Einleitung

Der Funktionsblock F_LEFT extrahiert die linken L Zeichen aus der Eingabezeichenkette IN. Er ist Teil der Standard-Character- und String-Funktionen gemäß IEC 61131-3.

F_LEFT

Schnittstellenstruktur

Ereignis-Eingänge

REQ: Startet die Extraktion der Zeichenkette. Wird mit den Daten-Eingängen IN und L verknüpft.

Ereignis-Ausgänge

CNF: Bestätigt die erfolgreiche Extraktion. Wird mit dem Daten-Ausgang OUT verknüpft.

Daten-Eingänge

IN (ANY_STRING): Die Eingabezeichenkette, aus der die linken Zeichen extrahiert werden sollen.
L (ANY_INT): Die Anzahl der Zeichen, die von links extrahiert werden sollen.

Daten-Ausgänge

OUT (ANY_STRING): Die extrahierte Teilzeichenkette, bestehend aus den linken L Zeichen von IN.

Adapter

Es sind keine Adapter vorhanden.

Funktionsweise

Bei Auslösung des Ereignisses REQ extrahiert der Funktionsblock die ersten L Zeichen aus der Eingabezeichenkette IN und gibt das Ergebnis über OUT aus. Das Ereignis CNF signalisiert die erfolgreiche Ausführung.

Technische Besonderheiten

Unterstützt alle String-Typen (ANY_STRING).
L muss ein gültiger Integer-Wert sein. Ist L größer als die Länge von IN, wird die gesamte Zeichenkette zurückgegeben.

Zustandsübersicht

Idle: Wartet auf das REQ-Ereignis.
Processing: Verarbeitet die Eingabe und extrahiert die Zeichen.
Completed: Sendet CNF mit dem Ergebnis.

Anwendungsszenarien

Extraktion von Präfixen aus Zeichenketten.
Verkürzung von Strings für spezifische Anforderungen.

⚖️ Vergleich mit ähnlichen Bausteinen

F_RIGHT: Extrahiert Zeichen von rechts.
F_MID: Extrahiert Zeichen aus der Mitte einer Zeichenkette.

Fazit

F_LEFT ist ein einfacher und effizienter Funktionsblock zur Extraktion von Teilzeichenketten aus dem Anfang eines Strings. Seine Verwendung ist intuitiv und erfüllt die Anforderungen gemäß IEC 61131-3.