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