tuple_ords
— Konvertieren eines Tupels von Strings in ein Tupel von
ganzen Zahlen.
tuple_ords
konvertiert das Eingabetupel T
, das nur Strings
und ganze Zahlen enthalten darf, in ein Tupel von Ganzzahlen.
Wenn die Stringkodierung der HALCON Bibliothek UTF-8 ist (siehe
set_system('filename_encoding','utf8')
) und die String-Operatoren
auf der Basis von Codepoints arbeiten (siehe
set_system('tuple_string_operator_mode','codepoint')
), was für beide
Optionen die Standardeinstellung ist, gibt der Operator für die
Eingabestrings die entsprechenden Unicode-Zeichencodes zurück.
Wenn die Stringkodierung der HALCON Bibliothek 'locale' ist oder die
String-Operatoren im Modus 'byte' arbeiten, gibt der Operator den
ANSI-Code für jeden Byte des Eingabestrings zurück.
In diesem Modus kann das Ergebnis von der aktuell verwenden Codepage für
Strings mit nicht-ASCII Zeichen abhängen.
Detailliertere Informationen zu den verschiedenen Modi und weitere Aspekte
zur Stringkodierung sind unter Tupel / String-Operationen zu finden.
Entsprechend ihrer Reihenfolge innerhalb des Strings und des Tupels, werden
die Zeichencodes der einzelnen Strings in das Ausgabetupel geschrieben.
Ganzzahlen werden entsprechend ihrer Position im Eingabetupel in das
Ausgabetupel kopiert.
Der Operator tuple_ords
kann genutzt werden, um Ausgaben mit
write_serial
vorzubereiten.
Insbesondere kann zwischen zwei Strings der Wert 0 als Trenner geschrieben
werden, indem die Ganzzahl 0 in das Eingabetupel T
eingefügt wird.
Falls das Eingabetupel leer ist, gibt der Operator ein leeres Tupel zurück.
HDevelop unterstützt eine Inline-Operation für tuple_ords
,
die innerhalb eines Ausdrucks in der folgenden Syntax verwendet werden
kann:
T
(input_control) string(-array) →
(string / integer)
Eingabetupel mit Strings.
Ords
(output_control) integer(-array) →
(integer)
Ausgabetupel mit den Unicode-Zeichencodes oder ANSI-Codes des Eingabestrings.
tuple_ords (['String 1', 0, 'String 2', 0], Data) write_serial (SerialHandle, Data)
tuple_chr
,
tuple_chrt
,
write_serial
Foundation