a1200   NEWS   APPS   DOCS   ABOUT
a1200
----
a1200
----
Autodocs
 Libraries:
 commodities.library
  ActivateCxObj
  AddIEvents
  AttachCxObj
  ClearCxObjError
  CreateCxObj
  CxBroker
  CxMsgData
  CxMsgID
  CxMsgType
  CxObjError
  CxObjType
  DeleteCxObj
  DeleteCxObjAll
  DisposeCxMsg
  DivertCxMsg
  EnqueueCxObj
  InsertCxObj
  InvertKeyMap
  MatchIX
  ParseIX
  RemoveCxObj
  RouteCxMsg
  SetCxObjPri
  SetFilter
  SetFilterIX
  SetTranslate
Include
GuruMeditation
Docs » Autodocs » commodities.library » EnqueueCxObj

NAME

	EnqueueCxObj -- insert a commodity object within a list of objects
		        based on object priority. (V36)

SYNOPSIS

	EnqueueCxObj(headObj,co);
		     A0      A1
	VOID EnqueueCxObj(CxObj *,CxObj *);

FUNCTION

	This function puts object 'co' into the list of object 'headObj'.
	The insertion point is determined by the object's priority. The
	objects are kept in the list from the highest priority to the
	lowest. New nodes are inserted in front of the first node with a
	lower priority. Hence a FIFO queue for nodes of equal priority.
	The priority of the commodity object can be set using SetCxObjPri().

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)

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.

SEE ALSO

SetCxObjPri(), CxObjError(), ClearCxObjError()

Comments

Name:
E-mail: Use this if you want a message if you get a response, will not be shown.
Comment:
Select correct short for:

Future Crew

FC
RSI
FLT
DJ

Comments:
$VER: d0.se 1.14 Copyright © 2011-2024 Tobias Geijersson support at d0 dot se