write_dictT_write_dictWriteDictWriteDictwrite_dict (Operator)
Name
write_dictT_write_dictWriteDictWriteDictwrite_dict — Abspeichern eines Dictionaries in einer Datei.
Signatur
void WriteDict(const HTuple& DictHandle, const HTuple& FileName, const HTuple& GenParamName, const HTuple& GenParamValue)
void HDict::WriteDict(const HString& FileName, const HTuple& GenParamName, const HTuple& GenParamValue) const
void HDict::WriteDict(const HString& FileName, const HString& GenParamName, const HString& GenParamValue) const
void HDict::WriteDict(const char* FileName, const char* GenParamName, const char* GenParamValue) const
void HDict::WriteDict(const wchar_t* FileName, const wchar_t* GenParamName, const wchar_t* GenParamValue) const
(Nur Windows)
Beschreibung
write_dictwrite_dictWriteDictWriteDictWriteDictwrite_dict speichert das Dictionary DictHandleDictHandleDictHandleDictHandledictHandledict_handle in
der Datei FileNameFileNameFileNameFileNamefileNamefile_name ab.
Die Datei wird als 'hdict' geschrieben, dem HALCON-Format für
Dictionaries.
Die Dateiendung für das Dictionary ist in HALCON 'hdict'.
Wenn DictHandleDictHandleDictHandleDictHandledictHandledict_handle ein Handle enthält, das nicht serialisiert werden
kann oder das schon freigegeben wurde, bricht write_dictwrite_dictWriteDictWriteDictWriteDictwrite_dict
standardmäßig mit einer Fehlermeldung ab. Dieses Verhalten kann durch Setzen
von GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name auf
'raise_error_if_content_not_serializable'"raise_error_if_content_not_serializable""raise_error_if_content_not_serializable""raise_error_if_content_not_serializable""raise_error_if_content_not_serializable""raise_error_if_content_not_serializable" verändert werden, der
zugehörige GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value kann folgende Werte annehmen:
- 'true'"true""true""true""true""true":
Das Standardverhalten, Fehler werden geworfen.
- 'false'"false""false""false""false""false":
Es wird kein Fehler geworfen, ein leeres
Handle wird anstatt des nicht serialisierbaren Handles geschrieben.
- 'low_level'"low_level""low_level""low_level""low_level""low_level":
Nur Low-Level-Fehler werden geworfen, die
das betroffene Handle enthalten. Ein leeres Handle wird anstatt des
nicht serialisierbaren Handles geschrieben. Der Umgang mit HALCON
Low-Level-Fehlern wird durch 'do_low_error'"do_low_error""do_low_error""do_low_error""do_low_error""do_low_error" in
set_systemset_systemSetSystemSetSystemSetSystemset_system bestimmt.
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
DictHandleDictHandleDictHandleDictHandledictHandledict_handle (input_control) dict → HDict, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Dictionaries.
Parameteranzahl: DictHandle == 1
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Dateiname der zu lesenden Datei.
Dateiendung: .hdict
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name des generischen Parameters.
Defaultwert: []
Werteliste: 'raise_error_if_content_not_serializable'"raise_error_if_content_not_serializable""raise_error_if_content_not_serializable""raise_error_if_content_not_serializable""raise_error_if_content_not_serializable""raise_error_if_content_not_serializable"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value (input_control) attribute.name(-array) → HTupleMaybeSequence[Union[int, float, str]]HTupleHtuple (string / integer / real) (string / int / long / double) (HString / Hlong / double) (char* / Hlong / double)
Wert des generischen Parameters.
Defaultwert: []
Wertevorschläge: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'low_level'"low_level""low_level""low_level""low_level""low_level"
Ergebnis
Sind die Parameterwerte korrekt, dann liefert write_dictwrite_dictWriteDictWriteDictWriteDictwrite_dict den
Wert TRUE. Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
read_dictread_dictReadDictReadDictReadDictread_dict,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle,
create_dictcreate_dictCreateDictCreateDictCreateDictcreate_dict
Nachfolger
read_dictread_dictReadDictReadDictReadDictread_dict
Siehe auch
read_dictread_dictReadDictReadDictReadDictread_dict,
serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle
Modul
Foundation