write_dictT_write_dictWriteDictWriteDict (Operator)
Name
write_dictT_write_dictWriteDictWriteDict
— 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_dictWriteDictWriteDictWriteDict
speichert das Dictionary DictHandleDictHandleDictHandleDictHandledictHandle
in
der Datei FileNameFileNameFileNameFileNamefileName
ab.
Die Datei wird als 'hdict' geschrieben, dem HALCON-Format für
Dictionaries.
Die Dateiendung für das Dictionary ist in HALCON 'hdict'.
Wenn DictHandleDictHandleDictHandleDictHandledictHandle
ein Handle enthält, das nicht serialisiert werden
kann oder das schon freigegeben wurde, bricht write_dictwrite_dictWriteDictWriteDictWriteDict
standardmäßig mit einer Fehlermeldung ab. Dieses Verhalten kann durch Setzen
von GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
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" verändert werden, der
zugehörige GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
kann folgende Werte annehmen:
- 'true'"true""true""true""true":
Das Standardverhalten, Fehler werden geworfen.
- '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":
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" in
set_systemset_systemSetSystemSetSystemSetSystem
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
DictHandleDictHandleDictHandleDictHandledictHandle
(input_control) dict →
HDict, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Handle des Dictionaries.
Parameteranzahl: DictHandle == 1
FileNameFileNameFileNameFileNamefileName
(input_control) filename.write →
HTupleHTupleHtuple (string) (string) (HString) (char*)
Dateiname der zu lesenden Datei.
Dateiendung: .hdict
GenParamNameGenParamNameGenParamNameGenParamNamegenParamName
(input_control) attribute.name(-array) →
HTupleHTupleHtuple (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"
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValue
(input_control) attribute.name(-array) →
HTupleHTupleHtuple (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", 'false'"false""false""false""false", 'low_level'"low_level""low_level""low_level""low_level"
Ergebnis
Sind die Parameterwerte korrekt, dann liefert write_dictwrite_dictWriteDictWriteDictWriteDict
den
Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
read_dictread_dictReadDictReadDictReadDict
,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle
,
create_dictcreate_dictCreateDictCreateDictCreateDict
Nachfolger
read_dictread_dictReadDictReadDictReadDict
Siehe auch
read_dictread_dictReadDictReadDictReadDict
,
serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandle
,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle
Modul
Foundation