tuple_str_bit_select — Auswählen eines einzelnen Zeichens oder Bits aus einem Tupel.
tuple_str_bit_select wählt aus einem Tupel Tuple von
Strings und/oder Zahlen ein einzelnes Zeichen beziehungsweise Bit aus und
gibt es in dem Ausgabetupel Selected zurück. Tuple kann
hierbei aus Strings und/oder ganzen Zahlen bestehen. Welches Zeichen
beziehungsweise Bit ausgewählt wird, hängt von dem Eingabeparameter
Index ab, der ausschließlich aus einer Zahl „n“ bestehen darf.
Ist dies eine Gleitkommazahl, so muss sie eine ganze Zahl repräsentieren
(d.h., alle Nachkommastellen müssen 0 sein). Das Ausgabetupel
Selected enthält nun für jedes Element aus Tuple ein
neues Element, das aus dem „n-ten“ Zeichen (bei Strings) beziehungsweise
dem „n-ten“ Bit (bei ganzen Zahlen) des korrespondierenden Elements von
Tuple besteht.
Falls Tuple leer ist, wird eine Fehlermeldung angezeigt.
Der Index bezieht sich auf Unicode Codepoints. Ein Codepoint kann
aus mehreren Bytes im UTF-8 String zusammengesetzt sein. Wenn der Index
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_bit_select,
die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden
kann:
Tuple (input_control) tuple(-array) → (string / integer)
Eingabetupel.
Index (input_control) integer → (integer)
Position des Zeichens oder Bits.
Selected (output_control) tuple(-array) → (string / integer)
Tupel mit den ausgewählten Zeichen und Bits.
tuple_select,
tuple_first_n,
tuple_last_n,
tuple_concat,
tuple_strchr,
tuple_strrchr,
tuple_str_first_n,
tuple_str_last_n,
tuple_substr,
tuple_and,
tuple_or,
tuple_xor,
tuple_not
Foundation