clear_template
— Deallocation of the memory of a template.
clear_template
is obsolete and is only provided for
reasons of backward compatibility. New applications should use the
shape-based or NCC-based operators instead.
clear_template( : : TemplateID : )
The operator clear_template
deallocates the memory of
a template which has been created by create_template
or create_template_rot
.
After execution of the operator clear_template
the template can no longer be used. The value
of TemplateID
is not valid.
However, the number can be used again by further calls of
create_template
or create_template_rot
.
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.
TemplateID
(input_control, state is modified) template →
(handle)
Template number.
If the number of the template is valid, the operator
clear_template
returns the value 2 (H_MSG_TRUE).
If necessary an exception is raised.
create_template
,
create_template_rot
,
read_template
,
write_template
Matching