SubStr() [v1.0.46+]

Ruft ein oder mehrere Zeichen von einer bestimmten Position in einer Zeichenkette ab.

NeueZkette := SubStr(Zkette, StartPos , Länge)

Parameter

Zkette

Die Zeichenkette, deren Inhalt kopiert wird.

StartPos

Geben Sie 1 an, um beim ersten Zeichen zu beginnen, 2, um beim zweiten zu beginnen, und so weiter. Wenn StartPos die Länge von Zkette überschreitet, wird eine leere Zeichenkette zurückgegeben.

Wenn StartPos kleiner als 1 ist, wird es als Offset vom Ende der Zeichenkette angesehen. Zum Beispiel würde 0 das letzte Zeichen und -1 die letzten zwei Zeichen extrahieren. Wenn StartPos aber das linke Ende der Zeichenkette überschreitet, beginnt die Extraktion beim ersten Zeichen.

Länge

Wenn weggelassen, werden standardmäßig "alle Zeichen" verwendet. Wenn leer, wird standardmäßig 0 verwendet. Andernfalls geben Sie die maximale Anzahl der zu extrahierenden Zeichen an (es werden weniger Zeichen abgerufen, wenn der Rest der Zeichenkette zu kurz ist).

Sie können auch eine negative Länge angeben, um diese bestimmte Anzahl von Zeichen vom Ende der zurückgegebenen Zeichenkette zu entfernen (es wird eine leere Zeichenkette zurückgegeben, wenn alle oder zu viele Zeichen weggelassen wurden).

Rückgabewert

Diese Funktion gibt die gewünschte Teilzeichenkette von Zkette zurück.

Bemerkungen

Die SubStr-Funktion und der StringMid-Befehl sind nahezu funktionsgleich. Allerdings wird SubStr empfohlen, da es flexibler und zukunftssicherer als StringMid ist.

RegExMatch(), StringMid, StringLeft/Right, StringTrimLeft/Right

Beispiele

Ruft die Teilzeichenkette ab Position 4 mit einer Länge von 3 Zeichen ab.

MsgBox % SubStr("123abc789", 4, 3) ; Gibt abc zurück

Ruft eine Teilzeichenkette am Anfang und Ende einer Zeichenkette ab.

Zkette := "The Quick Brown Fox Jumps Over the Lazy Dog"
MsgBox % SubStr(Zkette, 1, 19)  ; Gibt "The Quick Brown Fox" zurück
MsgBox % SubStr(Zkette, -7)  ; Gibt "Lazy Dog" zurück