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_tupleWriteTupleWriteTupleWriteTuplewrite_tuple schreibt den Inhalt von TupleTupleTupleTupletupletuple 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_tupleReadTupleReadTupleReadTupleread_tuple
wieder eingelesen werden. Die Dateiendung für Tupel ist in HALCON 'tup'.
Sonderfall: Handles
write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple kann keine Handles schreiben, da die entsprechenden
binären Daten vom geschriebenen ASCII-Format nicht unterstützt werden.
Handles, die in TupleTupleTupleTupletupletuple enthalten sind, werden von write_tuplewrite_tupleWriteTupleWriteTupleWriteTuplewrite_tuple
durch den Integer 0 ersetzt.
Um ein Tupel zu schreiben, das Handles enthält, können die Operatoren
serialize_tupleserialize_tupleSerializeTupleSerializeTupleSerializeTupleserialize_tuple und fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_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
TupleTupleTupleTupletupletuple (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.
FileNameFileNameFileNameFileNamefileNamefile_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_tupleWriteTupleWriteTupleWriteTuplewrite_tuple den
Wert 2 (H_MSG_TRUE). Andernfalls wird eine Fehlerbehandlung
durchgeführt.
Alternativen
fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteStringfwrite_string
Siehe auch
read_tupleread_tupleReadTupleReadTupleReadTupleread_tuple,
write_imagewrite_imageWriteImageWriteImageWriteImagewrite_image,
write_regionwrite_regionWriteRegionWriteRegionWriteRegionwrite_region,
open_fileopen_fileOpenFileOpenFileOpenFileopen_file
Modul
Foundation