write_messageT_write_messageWriteMessageWriteMessagewrite_message (Operator)
Name
write_messageT_write_messageWriteMessageWriteMessagewrite_message — Abspeichern einer Nachricht in einer Datei.
Signatur
void WriteMessage(const HTuple& MessageHandle, const HTuple& FileName, const HTuple& GenParamName, const HTuple& GenParamValue)
void HMessage::WriteMessage(const HString& FileName, const HTuple& GenParamName, const HTuple& GenParamValue) const
void HMessage::WriteMessage(const HString& FileName, const HString& GenParamName, const HString& GenParamValue) const
void HMessage::WriteMessage(const char* FileName, const char* GenParamName, const char* GenParamValue) const
void HMessage::WriteMessage(const wchar_t* FileName, const wchar_t* GenParamName, const wchar_t* GenParamValue) const
(Nur Windows)
Beschreibung
write_messagewrite_messageWriteMessageWriteMessageWriteMessagewrite_message speichert die Nachricht MessageHandleMessageHandleMessageHandleMessageHandlemessageHandlemessage_handle in
der Datei FileNameFileNameFileNameFileNamefileNamefile_name ab.
Die Dateiendung für die Nachricht ist in HALCON 'hmsg'.
Wenn MessageHandleMessageHandleMessageHandleMessageHandlemessageHandlemessage_handle ein Handle enthält, das nicht serialisiert werden
kann oder das schon freigegeben wurde, bricht write_messagewrite_messageWriteMessageWriteMessageWriteMessagewrite_message
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":
Der Default: Fehler werden geworfen und der Schreibprozess abgebrochen.
- 'low_level'"low_level""low_level""low_level""low_level""low_level":
Nur Low-Level-Fehler werden geworfen. Anstatt des betreffenden Handles
wird ein leeres Handle in FileNameFileNameFileNameFileNamefileNamefile_name geschrieben
und der Schreibprozess weitergeführt. 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.
- 'false'"false""false""false""false""false":
Es werden keine Fehler geworfen. Anstatt des betreffenden Handles
wird ein leeres Handle in FileNameFileNameFileNameFileNamefileNamefile_name
geschrieben und der Schreibprozess weitergeführt.
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
MessageHandleMessageHandleMessageHandleMessageHandlemessageHandlemessage_handle (input_control) message → HMessage, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Nachrichtenobjekt.
Parameteranzahl: MessageHandle == 1
Restriktion: MessageHandle != 0
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Dateiname der zu lesenden Datei.
Dateiendung: .hmsg
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_messagewrite_messageWriteMessageWriteMessageWriteMessagewrite_message den
Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
read_messageread_messageReadMessageReadMessageReadMessageread_message,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle,
create_messagecreate_messageCreateMessageCreateMessageCreateMessagecreate_message
Nachfolger
read_messageread_messageReadMessageReadMessageReadMessageread_message
Siehe auch
read_messageread_messageReadMessageReadMessageReadMessageread_message,
serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle
Modul
Foundation