clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item清除序列化项（算子）

名称

clear_serialized_itemT_clear_serialized_itemClearSerializedItemClearSerializedItemclear_serialized_item — 删除序列化项。

签名

描述

clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemClearSerializedItemclear_serialized_item 删除一个序列化项，该项通过句柄 SerializedItemHandleSerializedItemHandleSerializedItemHandleSerializedItemHandleserializedItemHandleserialized_item_handle 传递（序列化基础知识请参阅 fwrite_serialized_itemfwrite_serialized_itemFwriteSerializedItemFwriteSerializedItemFwriteSerializedItemfwrite_serialized_item）。若序列化项仅由数据指针创建，则不会被删除。此类指向序列化项起始位置的数据指针可通过算子 get_serialized_item_ptrget_serialized_item_ptrGetSerializedItemPtrGetSerializedItemPtrGetSerializedItemPtrget_serialized_item_ptr 创建。调用 clear_serialized_itemclear_serialized_itemClearSerializedItemClearSerializedItemClearSerializedItemclear_serialized_item 后，该序列化项的句柄将失效。

执行信息

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

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

• 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

模块

基础