# Zeichenfolge extrahieren (links/rechts)

Extrahiert eine Zeichenfolge vom linken oder rechten Rand.

##### Baustein

##### Text

TARGET = substringFromLeft(INPUT, COUNT);
1 2 4 3

# | Beschreibung
1 | [Destination Data] Legen Sie das Ziel fest, an dem Sie die extrahierte Zeichenfolge speichern möchten.
2 | Richtung zum Extrahieren der Zeichenfolge ##### Baustein [FromLeft] [FromRight] ##### Text 'substringFromLeft' 'substringFromRight' Wählen Sie die Richtung zum Extrahieren der Zeichenfolge aus. (Beispiel) Zeichenfolge:"ABCDE", [Number of characters]: 3 Rot Zeichen werden extrahiert. Bei Auswahl von [FromLeft]: ABC DE Bei Auswahl von [FromRight]: AB CDE
3 | [Number of characters] Legen Sie einen Baustein fest, der die Anzahl der zu extrahierenden Zeichen angibt. Der Wert muss größer oder gleich 1 und kleiner oder gleich der Anzahl der Zeichen sein, die extrahiert werden können. Doppelbytezeichen werden als einzelnes Zeichen gezählt.
4 | [Source Data] Legen Sie die Quelldaten fest, in denen die zu konvertierende Zeichenfolge gespeichert ist.

(Beispiel)

##### Baustein

##### Text

Var4 = substringFromLeft(Var3,Var1);

## Operationsbeispiel

Variable in [Source Data] | [Way to extract] | [Number of characters] | Variable in [Destination Data] | Kommentare
Zielzeichenfolge | Maximale Anzahl von Bytes | Extrahierte Zeichenfolge zum Speichern
ABCDE | FromLeft | 3 | 5 | ABC | -
0 | 5 | (keine) | Eine Zeichenfolge wird nicht gespeichert, da der Wert in [Number of characters] weniger als 1 ist. Im „Operationsergebnis“ wird dies als fehlgeschlagen beurteilt.
3.6 | 5 | ABC | Die Werte rechts vom Dezimalzeichen in [Number of characters] werden weggelassen.
FromRight | 3 | 5 | CDE | -
-1 | 5 | (keine) | Eine Zeichenfolge wird nicht gespeichert, da der Wert in [Number of characters] weniger als 1 ist. Im „Operationsergebnis“ wird dies als fehlgeschlagen beurteilt.
3.7 | 5 | CDE | Die Werte rechts vom Dezimalzeichen in [Number of characters] werden weggelassen.
AB | FromLeft | 3 | 5 | (keine) | Eine Zeichenfolge wird nicht gespeichert, da der Wert in [Number of characters] die Anzahl der abrufbaren Zeichen überschreitet. Im „Operationsergebnis“ wird dies als fehlgeschlagen beurteilt.
FromRight | 3 | 5 | (keine) | Eine Zeichenfolge wird nicht gespeichert, da der Wert in [Number of characters] die Anzahl der abrufbaren Zeichen überschreitet. Im „Operationsergebnis“ wird dies als fehlgeschlagen beurteilt.
ABCD(0x00)C | FromRight | 3 | 5 | BCD | Bei NULL (0x00) endet dort die Zeichenfolge.
AB(0x00)CD | FromLeft | 3 | 5 | (keine) | Zeichenfolge wird nicht gespeichert. Bei NULL (0x00) endet dort die Zeichenfolge. Daher überschreitet der Wert in [Number of characters] die Anzahl der abrufbaren Zeichen. Im „Operationsergebnis“ wird dies als fehlgeschlagen beurteilt.
AB(0x00)CDEF | FromRight | 3 | 5 | (keine) | Zeichenfolge wird nicht gespeichert. Bei NULL (0x00) endet dort die Zeichenfolge. Daher überschreitet der Wert in [Number of characters] die Anzahl der abrufbaren Zeichen. Im „Operationsergebnis“ wird dies als fehlgeschlagen beurteilt.
ABCDEFGH | FromLeft | 6 | 5 | (keine) | Eine Zeichenfolge wird nicht gespeichert, da die konvertierte Zeichenfolge die maximal zu speichernde Byte-Zahl überschreitet. Im „Operationsergebnis“ wird dies als fehlgeschlagen beurteilt.
FromRight | 6 | 5 | (keine) | Eine Zeichenfolge wird nicht gespeichert, da die konvertierte Zeichenfolge die maximal zu speichernde Byte-Zahl überschreitet. Im „Operationsergebnis“ wird dies als fehlgeschlagen beurteilt.
AあB | FromLeft | 3 | 5 | AあB | Die Zeichenfolgenspeicherung basiert auf dem Wert in [Number of characters]. *1
FromRight | 2 | 5 | あB | Die Zeichenfolgenspeicherung basiert auf dem Wert in [Number of characters]. *1

*1 Wenn die Höchstzahl an Bytes in der Variable [Destination Data] geringer ist als die Größe der abgerufenen Zeichenfolge, schlägt der Vorgang fehl. Die Höchstzahl der Bytes hängt von der Codierung der Variable [Destination Data] ab.