Home / Autodocs / commodities.library
NAME
- InsertCxObj
-
insert a commodity object in a list after a given object. (V36)
SYNOPSIS
InsertCxObj(headObj,co,pred);
VOID InsertCxObj(CxObj *,CxObj *,CxObj *);
A0 A1 A2
FUNCTION
Adds 'co' to the list of objects pointed to by 'headObj' after object 'pred'.
INPUTS
- headObj
-
pointer to a list of objects. If this value is NULL, then the entire tree of objects pointed to by 'co' is deleted and becomes invalid.
- co
-
the object to add to the list (may be NULL)
- pred
-
the object after which 'co' should be inserted. If this is NULL then 'co' is added to the head of the list.
RESULT
If 'co' is NULL, this function will record that fact in the internal accumulated error of 'headObj'. This error record can be retrieved using CxObjError() and cleared using ClearCxObjError().
BUGS
Until V38, passing a NULL 'headObj' parameter would cause low-memory access and unpredictable results.