LEFT

Zeichen von links

LEFT kopiert, ausgehend von links, n Zeichen der als erste Eingangsvariable angegebenen Zeichenfolge in die Ausgangsvariable. Die Anzahl der zu liefernden Zeichen L legen Sie mit der zweiten Eingangsvariable fest.

Parameter

Eingang

IN (STRING): Eingangszeichenfolge
L (INT): Anzahl der Zeichen der Eingangszeichenfolge, die von links kopiert werden

Ausgang

Unnamed output (STRING): kopierte Zeichenfolge

Anmerkungen

Wenn Sie diesen Befehl mit UTF-8-Zeichenfolgen verwenden, beachten Sie die Hinweise zu UTF-8-Zeichenfolgen unter dem Datentyp STRING.
Wenn die Anzahl der zu liefernden Zeichen größer ist als die Eingangszeichenfolge, wird die gesamte Zeichenfolge in die Ausgangsvariable output_string kopiert.
Wenn die Ausgangs-Zeichenfolge länger ist als die für die Ausgangsvariable im Feld “Typ” definierte Länge, werden nur so viele Zeichen kopiert, wie in die Ausgangsvariable passen.Die Systemvariable sys_bIsCarry wird gesetzt.

Fehleralarmmerker

sys_bIsOperationErrorHold (wird auf TRUE gesetzt und bleibt TRUE): wenn eine am Eingang oder Ausgang angegebene Zeichenfolge eine ungültige Zeichenfolge ist
sys_bIsOperationErrorNonHold (wird für einen Zyklus auf TRUE gesetzt): wenn eine am Eingang oder Ausgang angegebene Zeichenfolge eine ungültige Zeichenfolge ist
sys_bIsCarry (wird für einen Zyklus auf TRUE gesetzt): wenn die Ausgangs-Zeichenfolge länger ist als die für die Ausgangsvariable im Feld "Typ" definierte Länge

Verwandte Themen

STRING

Ungültige Zeichenfolgen

Beispiel

POE-Kopf

Im POE-Kopf werden alle Ein- und Ausgangsvariablen deklariert, die für die Programmierung dieser Funktion verwendet werden. Für alle Programmiersprachen wird der gleiche POE-Kopf verwendet.

	VAR
		input_string: STRING[15]:='Ideas for life';
			(*sample string*)
		output_string: STRING[5]:='';
			(*result: here 'Ideas'*)
		character_number: INT:=5;
			(*characters to be delivered*)
	END_VAR

In diesem Beispiel wurden die Eingangsvariablen input_string und character_number deklariert. Stattdessen können Sie die Eingangszeichenfolge ('Ideas for life') und die Anzahl der zu liefernden Zeichen auch direkt an die Eingänge der Funktion schreiben. Die Zeichenfolge muss im POE-Kopf und an den Funktionseingängen in Apostrophen stehen.

POE-Rumpf

Aus input_string ('Ideas for life’) werden, ausgehend von links, die mit character_number festgelegte Anzahl Zeichen (5) in output_string ('Ideas’) kopiert.

KOP-Rumpf

BODY
    WORKSPACE
        NETWORK_LIST_TYPE := NWTYPELD ;
        ACTIVE_NETWORK := 0 ;
    END_WORKSPACE
    NET_WORK
        NETWORK_TYPE := NWTYPELD ;
        NETWORK_LABEL :=  ;
        NETWORK_TITLE :=  ;
        NETWORK_HEIGHT := 4 ;
        NETWORK_BODY
B(B_F,LEFT!,Instance,11,0,16,4,,?DIN?DL?C);
B(B_VARIN,,input_string,9,1,11,3,);
B(B_VARIN,,character_number,9,2,11,4,);
B(B_VAROUT,,output_string,16,1,18,3,);
L(1,0,1,4);
        END_NETWORK_BODY
    END_NET_WORK
END_BODY

ST-Rumpf

output_string:=LEFT(IN:=input_string, L:=character_number);

AWL-Rumpf

LD	input_string
LEFT	character_number
ST	output_string