set_message_obj — Add a key/object pair to the message.
set_message_obj stores an object associated with a key in the
message, which behaves as a dictionary-like data container.
The message is denoted by the
ObjectData is copied by the operation (copying the object data
in HALCON's object database, see
copy_obj), and can thus be
immediately reused. Both an empty object or an object tuple are considered
as a valid value that can be associated with the key.
If any data (tuple or object) was already associated with given key
Key), the old data is destroyed by
and replaced by
Key has to be a string or an integer.
String keys are treated case sensitive.
The object data for the given key can be retrieved again from the message
This operator modifies the state of the following input parameter:
During execution of this operator, access to the value of this parameter must be synchronized if it is used across multiple threads.
Object to be associated with the key.
MessageHandle(input_control, state is modified) message
Number of elements: MessageHandle == 1
MessageHandle != 0
→(string / integer)
Key string or integer.
Number of elements: Key == 1
create_message (Message) read_image( Image, 'filename') set_message_obj (Image, Message, 'my_image')
If the operation succeeds,
set_message_tuple returns 2 (H_MSG_TRUE).
Otherwise an exception is raised. Possible error conditions include
invalid parameters (handle or key) or resource allocation error.