clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item (算子)

名称

clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item — 删除序列化项。

签名

描述

clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemClearSerializedItemclear_serialized_item deletes a serialized item, which is passed by the handle SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle (see fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_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_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr。After calling clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemClearSerializedItemclear_serialized_item, the handle of the serialized item becomes invalid.

执行信息

• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 未采用并行化处理。

此算子修改后续输入参数的状态：

• SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle

在执行此算子时，若该参数值需在多个线程间使用，则必须对其访问进行同步。

参数

结果

如果参数有效，算子 clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemClearSerializedItemclear_serialized_item 返回值 2 ( H_MSG_TRUE )。如有必要，则抛出异常。

可能的前趋

fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item, receive_serialized_itemreceive_serialized_itemReceiveSerializedItemReceiveSerializedItemReceiveSerializedItemreceive_serialized_item

模块

基础