prg_list_join()
Abstract
Joins two lists.
Syntax
prg_list_join (front_lptr, back_lptr)
| Argument | Type | Description |
|---|---|---|
front_lptr |
PrgT_List* |
pointer to the first list. |
back_lptr |
PrgT_List* |
pointer to the list to be appended to the first list. |
Return Type
PrgT_Compcode
PrgC_Compcode_Success if the lists are joined successfully; PrgC_Compcode_Failure otherwise.
Header
prg_list_funcs.h
Details
This function appends the back_lptr values to front_lptr. Back_lptr is an empty list after a successful join.
WARNING: This function is MT unsafe, as described in “Multi-Threading Safety“ on page 11. Access to shared lists must be externally serialized.