deserialize_templateT_deserialize_templateDeserializeTemplateDeserializeTemplate (Operator)

Name

deserialize_templateT_deserialize_templateDeserializeTemplateDeserializeTemplate — Deserialize a serialized template.

Warning

deserialize_templatedeserialize_templateDeserializeTemplateDeserializeTemplateDeserializeTemplate is obsolete and is only provided for reasons of backward compatibility. New applications should use the shape-based or NCC-based operators instead.

Signature

deserialize_template( : : SerializedItemHandle : TemplateID)

Herror T_deserialize_template(const Htuple SerializedItemHandle, Htuple* TemplateID)

void DeserializeTemplate(const HTuple& SerializedItemHandle, HTuple* TemplateID)

void HTemplate::DeserializeTemplate(const HSerializedItem& SerializedItemHandle)

static void HOperatorSet.DeserializeTemplate(HTuple serializedItemHandle, out HTuple templateID)

void HTemplate.DeserializeTemplate(HSerializedItem serializedItemHandle)

Description

deserialize_templatedeserialize_templateDeserializeTemplateDeserializeTemplateDeserializeTemplate deserializes a template, that was serialized by serialize_templateserialize_templateSerializeTemplateSerializeTemplateSerializeTemplate (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItem for an introduction of the basic principle of serialization). The serialized template is defined by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle. The deserialized values are stored in an automatically created template with the handle TemplateIDTemplateIDTemplateIDTemplateIDtemplateID.

Execution Information

Parameters

SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandle (input_control)  serialized_item HSerializedItem, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the serialized item.

TemplateIDTemplateIDTemplateIDTemplateIDtemplateID (output_control)  template HTemplate, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Template number.

Result

If the parameters are valid, the operator deserialize_templatedeserialize_templateDeserializeTemplateDeserializeTemplateDeserializeTemplate returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.

Possible Predecessors

fread_serialized_itemfread_serialized_itemFreadSerializedItemFreadSerializedItemFreadSerializedItem, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItem, serialize_templateserialize_templateSerializeTemplateSerializeTemplateSerializeTemplate

Possible Successors

adapt_templateadapt_templateAdaptTemplateAdaptTemplateAdaptTemplate, set_reference_templateset_reference_templateSetReferenceTemplateSetReferenceTemplateSetReferenceTemplate, set_offset_templateset_offset_templateSetOffsetTemplateSetOffsetTemplateSetOffsetTemplate, best_matchbest_matchBestMatchBestMatchBestMatch, fast_matchfast_matchFastMatchFastMatchFastMatch, best_match_rotbest_match_rotBestMatchRotBestMatchRotBestMatchRot

Module

Matching