write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple (Operator)
Name
write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple — Schreiben des Inhalts eines Tupels in eine Datei.
Signatur
def write_tuple(tuple: MaybeSequence[Union[float, int, str]], file_name: str) -> None
Beschreibung
write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple schreibt den Inhalt von TupleTupleTupletupletuple auf Datei. Es
handelt sich hierbei um ein ASCII Format, d.h. die Daten sind zwischen
unterschiedlichen Rechnertypen austauschbar (siehe auch
Tupel / String-Operationen).
Die Daten können mit dem Operator read_tupleread_tupleReadTupleReadTupleread_tuple
wieder eingelesen werden. Die Dateiendung für Tupel ist in HALCON 'tup'.
Sonderfall: Handles
write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple kann keine Handles schreiben, da die entsprechenden
binären Daten vom geschriebenen ASCII-Format nicht unterstützt werden.
Handles, die in TupleTupleTupletupletuple enthalten sind, werden von write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple
durch den Integer 0 ersetzt.
Um ein Tupel zu schreiben, das Handles enthält, können die Operatoren
serialize_tupleserialize_tupleSerializeTupleSerializeTupleserialize_tuple und fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item verwendet werden.
Ausführungsinformationen
- Multithreading-Typ: independent (läuft parallel auch zu exklusiven Operatoren).
- Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
- Wird ohne Parallelisierung verarbeitet.
Parameter
TupleTupleTupletupletuple (input_control) tuple(-array) → HTupleMaybeSequence[Union[float, int, str]]HTupleHtuple (real / integer / string) (double / int / long / string) (double / Hlong / HString) (double / Hlong / char*)
Tupel mit beliebigen Werten.
FileNameFileNameFileNamefileNamefile_name (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Name der zu schreibenden Datei.
Dateiendung:
.tup
Ergebnis
Sind die Parameter korrekt, dann liefert write_tuplewrite_tupleWriteTupleWriteTuplewrite_tuple den
Wert 2 (
H_MSG_TRUE)
. Andernfalls wird eine Fehlerbehandlung
durchgeführt.
Alternativen
fwrite_stringfwrite_stringFwriteStringFwriteStringfwrite_string
Siehe auch
read_tupleread_tupleReadTupleReadTupleread_tuple,
write_imagewrite_imageWriteImageWriteImagewrite_image,
write_regionwrite_regionWriteRegionWriteRegionwrite_region,
open_fileopen_fileOpenFileOpenFileopen_file
Modul
Foundation