prg_list_cell_remove()

Abstract

Quickly removes a cell from a linked list.

Syntax

prg_list_cell_remove (list_ptr, cell_ptr)
Argument Type Description
list_ptr PrgT_List * List of interest
cell_ptr PrgT_List_Cell * Cell to be removed

Return Type

void

No return value.

prg_list_funcs.h

Details

This function is implemented as by inline definitions for faster operation. No error checking is done to verify the validity of the cell pointer. This function deallocates the cell memory, but the caller is responsible for deallocating the cell contents.

WARNING: This function is MT unsafe, as described in “Multi-Threading Safety“ on page 11. Access to shared lists must be externally serialized.

Purpose:

This function provides a way to quickly remove a list element. It can be used when doing fast iterations over linked lists.

Errors:

  • Program Abort: Segmentation violation. (due to an illegal list pointer, cell pointer, or malformed list)

Reference:

本站文档由 北京智网畅联科技有限公司 整理、翻译并提供 · Documentation compiled and provided by Beijing ZNetLink Technology Co., Ltd.

交流群 · QQ Group:OPNET/智网妙算网络仿真交流群(群号 486383494)

原文档 © 2017 Riverbed Technology · 本站为公益翻译,由 AI 辅助完成,请仔细甄别

Original documentation © 2017 Riverbed Technology. Community translation, AI-assisted. Contact: jiazequn@znetlink.com