write_messageT_write_messageWriteMessageWriteMessage (Operator)
Name
write_messageT_write_messageWriteMessageWriteMessage — 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_messageWriteMessageWriteMessageWriteMessage speichert die Nachricht MessageHandleMessageHandleMessageHandleMessageHandlemessageHandle in
der Datei FileNameFileNameFileNameFileNamefileName ab.
Die Dateiendung für die Nachricht ist in HALCON 'hmsg'.
Wenn MessageHandleMessageHandleMessageHandleMessageHandlemessageHandle ein Handle enthält, das nicht serialisiert werden
kann oder das schon freigegeben wurde, bricht write_messagewrite_messageWriteMessageWriteMessageWriteMessage
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":
Der Default: Fehler werden geworfen und der Schreibprozess abgebrochen.
- '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 FileNameFileNameFileNameFileNamefileName geschrieben
und der Schreibprozess weitergeführt. Der Umgang mit HALCON
Low-Level-Fehlern wird durch do_low_errordo_low_errordo_low_errordo_low_errordoLowError in set_systemset_systemSetSystemSetSystemSetSystem
bestimmt.
- 'false'"false""false""false""false":
Es werden keine Fehler geworfen. Anstatt des betreffenden Handles
wird ein leeres Handle in FileNameFileNameFileNameFileNamefileName
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
MessageHandleMessageHandleMessageHandleMessageHandlemessageHandle (input_control) message → HMessage, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Nachrichtenobjekt.
Parameteranzahl: MessageHandle == 1
Restriktion: MessageHandle != 0
FileNameFileNameFileNameFileNamefileName (input_control) filename.write → HTupleHTupleHtuple (string) (string) (HString) (char*)
Dateiname der zu lesenden Datei.
Dateiendung: .hmsg
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_messagewrite_messageWriteMessageWriteMessageWriteMessage den
Wert 2 (H_MSG_TRUE). Gegebenenfalls wird eine Fehlerbehandlung durchgeführt.
Vorgänger
read_messageread_messageReadMessageReadMessageReadMessage,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle,
create_messagecreate_messageCreateMessageCreateMessageCreateMessage
Nachfolger
read_messageread_messageReadMessageReadMessageReadMessage
Siehe auch
read_messageread_messageReadMessageReadMessageReadMessage,
serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandle,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandle
Modul
Foundation