CxTranslate

create a commodity translator object. (V36)

This function creates a Commodities 'translator' object. The action of this object on receiving a Commodities message is to replace that message in the commodities network with a chain of Commodities input messages.

There is one new Commodities input message generated for each input event in the linked list starting at 'ie' (and NULL terminated). The routing information of the new input messages is copied from the input message they replace.

The linked list of input events associated with a translator object can be changed using the SetTranslate() function.

If 'ie' is NULL, the null translation occurs: that is, the original commodities input message is disposed, and no others are created to take its place.

This function is a C-language macro for CreateCxObj(), defined in <libraries/commodities.h>.

ie

The input event list used as replacement by the translator

The list of input events manipulated by a translator object is inserted in reverse order in the commodities network, and come out of the network in reverse order as well.

The InvertString() function creates lists of input events that are in reverse order so they can be used directly with translator objects.

If you are not using the InvertString() function then you will have to either flip the list of input events or make sure that the list is always filled in reverse order to begin with.

translatorObj

A pointer to the translator object, or NULL if it could not be created.

commodities.library/CreateCxObj(), commodities.library/SetTranslate(), InvertString()