tuple_str_last_n — Ausschneiden aller Zeichen ab der Position „n“ aus einem Stringtupel.
tuple_str_last_n schneidet aus jedem String des Eingabetupels
String alle Zeichen bis zum String-Ende beginnend mit dem Zeichen
an der Position „n“ aus und liefert sie als einen
neuen String in dem Ausgabetupel Substring zurück.
Die Zahl „n“ wird hierbei durch das zweite Eingabetupel Position
definiert. Enthält Position nur ein Element, so legt dieses Element
die Zahl „n“ für alle Strings von String fest.
Beinhaltet Position genauso viele Elemente wie String, so
legt das erste Element von Position die Zahl „n“ für den
ersten String von String fest, das zweite Element von
Position legt die Zahl „n“ für den zweiten String
von String fest und so weiter. Enthält Position mehr als ein
Element und besteht String nur aus einem String, so werden aus
diesem String mehrere Endsegmente ausgeschnitten, deren Länge durch
die Elemente von Position festgelegt ist. Beinhalten die beiden
Eingabetupel mehr als ein Element und besitzen sie eine unterschiedliche
Zahl an Elementen, so bricht tuple_str_last_n mit einer
Fehlermeldung ab.
Falls beide Eingabetupel leer sind, gibt der Operator ein leeres Tupel
zurück. Gleichermaßen gibt der Operator ein leeres Tupel zurück, wenn
String leer ist und Position nicht. Falls jedoch
Position leer ist und String nicht, wird eine
Fehlermeldung angezeigt.
Die Position bezieht sich auf Unicode Codepoints. Ein Codepoint kann
aus mehreren Bytes im UTF-8 String zusammengesetzt sein. Wenn die Position
sich auf die Bytes des Strings beziehen soll, kann dieser Operator mit
set_system('tsp_tuple_string_operator_mode', 'byte') in einen
Byte-Modus umgeschaltet werden. Wenn 'filename_encoding' auf
'locale' gesetzt ist (legacy), verwendet dieser Operator immer den
Byte-Modus.
Für allgemeine Informationen zu String-Operationen siehe auch Tupel / String-Operationen.
HDevelop unterstützt eine Inline-Operation für tuple_str_last_n,
die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden
kann:
Substring := str_lastn(String, Position)
String (input_control) string(-array) → (string)
Eingabetupel mit zu untersuchenden Strings.
Position (input_control) number(-array) → (integer / real)
Eingabetupel mit den Positionen „n“.
Substring (output_control) string(-array) → (string)
Alle Zeichen von den Positionen „n“ bis zum String-Ende für alle Eingabestrings.
tuple_str_first_n,
tuple_substr,
tuple_strstr,
tuple_strrstr,
tuple_strlen,
tuple_strchr,
tuple_strrchr,
tuple_split,
tuple_environment
Foundation