STR_CUT, MID, SUBSTR

Die Funktionen STR_CUT, MID und SUBSTR kopieren Zeichen einer Zeichenfolge und ermöglichen es Ihnen, die resultierende Zeichenfolge zu kürzen. Verwenden Sie diese Funktionen, wenn Sie alle oder Teile von Zeichenfolgen kopieren möchten. Definieren Sie, von welchem Zeichen aus mit dem Kopieren begonnen werden soll, und definieren Sie optional die Anzahl der Zeichen, die Sie kopieren möchten.

Diese Script-Funktionen dienen alle einem a ähnlichen Zweck, nämlich einen Teil einer Zeichenfolge zu kopieren. Definieren Sie die Zeichenfolge, aus der Sie die Zeichen kopieren möchten, und welches Zeichen in dieser Zeichenfolge Sie von Start aus kopieren möchten. Geben Sie optional die Länge an, wenn Sie nur eine bestimmte Anzahl von Zeichen kopieren möchten. Wenn Sie keine Länge angeben, gibt die Funktion alle Zeichen bis zum Ende der Zeichenfolge zurück.

Hinweis: Sie können eine absolute Länge angeben, die die Anzahl der Zeichen überschreitet, die in der Zeichenfolge zur Verfügung stehen. In diesem Fall geben die Funktionen die definierten Zeichen mit zusätzlichen Leerzeichen an, die angehängt werden. Bei Bedarf können Sie diese Leerzeichen mit der STR_RTRIM-Funktion kürzen.

Die ursprüngliche Zeichenfolge selbst bleibt unverändert, da Sie die neue Zeichenfolge in einer Variable speichern. 

Syntax

STR_CUT (String, Start[, Länge])
MID (String, Start[, Länge])
SUBSTR (String, Start[, Länge])

Parameter

• STR_CUT, MID oder SUBSTR
  Kopiert die Zeichen einer Zeichenfolge

• String
  Alphanumerischer String
  Format: Script-Literal oder Script-Variable

• Start
  Startposition für das Kopieren
  Format: Zahl ohne Anführungszeichen oder Script-Variable

• Länge
  (Optional) Die Anzahl der zu kopierenden Zeichen
  Format: Zahl ohne Anführungszeichen oder Script-Variable

Rückgabewert: Der angegebene Teil des Strings

Beispiele

Das folgende Skript gibt alle Zeichen zurück, beginnend mit dem vierten Zeichen bis zum Ende der Zeichenfolge. Das Ergebnis ist System.

:SET &PARTOFSTRING# = SUBSTR("AE System", 4)

Im folgenden Beispiel werden zwei Zeichen zurückgegeben, beginnend mit dem dritten Zeichen der Zeichenfolge. Das Ergebnis ist CD.

:SET &STRING# = MID("ABCDEFGH",3,2)

Im folgenden Beispiel werden alle Zeichen zurückgegeben, die mit dem dritten Zeichen beginnen. Das zurückgegebene Ergebnis ist CDEFGH.

:SET &STRING# = SUBSTR("ABCDEFGH",3)

Im folgenden Beispiel wird eine Länge festgelegt, die die Anzahl der Zeichen überschreitet, die in der Zeichenfolge verfügbar sind. Aus diesem Grund fügt die Funktion leere Zeichen für die fehlenden Zeichen ein. Das Ergebnis ist >>CDEFGH    <<.

:SET &STRING# = STR_CUT("ABCDEFGH",3,10)

:PRINT ">>&STRING#<<"

Das folgende Script teilt einen benutzerdefinierten Begriff auf. Die ersten drei Zeichen werden dabei der ersten Script-Variable, das letzte Zeichen der zweiten Script-Variable zugewiesen.

:READ &TABNAME#, "04", "Bitte geben Sie den Tabellennamen an: xxxy"
:SET &TABPRE# = SUBSTR(&TABNAME#,1,3)
:SET &TABSUF# = SUBSTR(&TABNAME#,4,1)

Siehe auch: