Home / Autodocs / commodities.library
NAME
- DivertCxMsg
-
send a commodity message down an object list. (V36)
SYNOPSIS
DivertCxMsg(cxm,headObj,returnObj);
VOID DivertCxMsg(struct CxMsg *,CxObj *,CxObj *);
A0 A1 A2
FUNCTION
This function sends the commodity message 'cxm' down the list of objects attached to 'headObj'. The pointer 'returnObj' is first pushed onto the routing stack of 'cxm' so that when the end of the list of 'headObj' is reached the SUCCESSOR of 'returnObj' is the next destination.
For example, when a filter finds a match with a message, the message is diverted down the filter's list like this:
For example, when a filter finds a match with a message, the message is diverted down the filter's list like this:
DivertCxMsg(cxm,filter,filter);
INPUTS
- cxm
-
the commodity message to divert (must NOT be NULL)
- headObj
-
the list of objects to divert the message to
- returnObj
-
the object to use as a place holder