clear_serialized_item — Delete a serialized item.
clear_serialized_item( : : SerializedItemHandle : )
clear_serialized_item deletes a serialized item, which is passed by the handle SerializedItemHandle (see fwrite_serialized_item for an introduction of the basics of serialization). If a serialized item is created only by a data pointer, it will not be deleted. Such a data pointer, that points to the beginning of serialized item can be created by the operator get_serialized_item_ptr. After calling clear_serialized_item, the handle of the serialized item becomes invalid.
Handle of the serialized item.
If the parameters are valid, the operator clear_serialized_item returns the value 2 (H_MSG_TRUE). If necessary, an exception is raised.