write_messageT_write_messageWriteMessageWriteMessagewrite_message (Operator)
Name
write_messageT_write_messageWriteMessageWriteMessagewrite_message — Write a message to a file.
Signature
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
(Windows only)
Description
write_messagewrite_messageWriteMessageWriteMessageWriteMessagewrite_message writes the message denoted by the
MessageHandleMessageHandleMessageHandleMessageHandlemessageHandlemessage_handle to the file given by FileNameFileNameFileNameFileNamefileNamefile_name.
The default HALCON file extension for a message is 'hmsg'.
If MessageHandleMessageHandleMessageHandleMessageHandlemessageHandlemessage_handle contains a handle that can not be serialized or
that has been freed already, an exception is raised per default.
This behavior is controlled by GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name
'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", and the corresponding
GenParamValueGenParamValueGenParamValueGenParamValuegenParamValuegen_param_value can take the following values:
- 'true'"true""true""true""true""true":
The default: Errors are raised and the writing process aborted.
- 'low_level'"low_level""low_level""low_level""low_level""low_level":
Only low level errors are raised. Instead of the handle concerned an empty
handle is written in FileNameFileNameFileNameFileNamefileNamefile_name and the writing
process will be continued. The behavior regarding HALCON low level errors
is determined by 'do_low_error'"do_low_error""do_low_error""do_low_error""do_low_error""do_low_error" in set_systemset_systemSetSystemSetSystemSetSystemset_system.
- 'false'"false""false""false""false""false":
The errors are suppressed. Instead of the handle concerned an empty
handle is written in FileNameFileNameFileNameFileNamefileNamefile_name and the writing
process will be continued.
Execution Information
- Multithreading type: independent (runs in parallel even with exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
MessageHandleMessageHandleMessageHandleMessageHandlemessageHandlemessage_handle (input_control) message → HMessage, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Message handle.
Number of elements: MessageHandle == 1
Restriction: MessageHandle != 0
FileNameFileNameFileNameFileNamefileNamefile_name (input_control) filename.write → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
File name.
File extension: .hmsg
GenParamNameGenParamNameGenParamNameGenParamNamegenParamNamegen_param_name (input_control) attribute.name(-array) → HTupleMaybeSequence[str]HTupleHtuple (string) (string) (HString) (char*)
Name of the generic parameter.
Default value: []
List of values: '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)
Value of the generic parameter.
Default value: []
Suggested values: 'true'"true""true""true""true""true", 'false'"false""false""false""false""false", 'low_level'"low_level""low_level""low_level""low_level""low_level"
Result
If the parameters are valid, the operator write_messagewrite_messageWriteMessageWriteMessageWriteMessagewrite_message returns
the value 2 (H_MSG_TRUE). If necessary an exception is raised.
Possible Predecessors
read_messageread_messageReadMessageReadMessageReadMessageread_message,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle,
create_messagecreate_messageCreateMessageCreateMessageCreateMessagecreate_message
Possible Successors
read_messageread_messageReadMessageReadMessageReadMessageread_message
See also
read_messageread_messageReadMessageReadMessageReadMessageread_message,
serialize_handleserialize_handleSerializeHandleSerializeHandleSerializeHandleserialize_handle,
deserialize_handledeserialize_handleDeserializeHandleDeserializeHandleDeserializeHandledeserialize_handle
Module
Foundation