prg_list_cell_data_get()
Abstract
Quickly obtains the data associated with a specified list cell.
Syntax
prg_list_cell_data_get (cell_ptr)
| Argument | Type | Description |
|---|---|---|
cell_ptr |
PrgT_List_Cell * |
Cell of interest. |
Return Type
void *
The requested data.
Header
prg_list_funcs.h
Details
This function is implemented as an inline definition for faster operation. No error checking is done to verify the validity of the cell pointer.
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 obtain the data associated with a list element. It can be used when doing fast iterations over linked lists.
Errors:
- Program Abort: Segmentation violation. (due to an illegal cell pointer or malformed list)
Reference:
- use
prg_list_head_cell_get()to obtain a reference to the head cell of a list - use
prg_list_cell_next_get()to obtain a reference to the next cell of a list