Clara-Doc - Method Reference

 / packages  / CTBASE  / Version 01.00.00  / CTLST

CTLST_Constructor
Description
Creates a CTLST instance in memory. This method must be called in order to use a linked list. The constructor method is equivalent to the new operator in C++ and Java. The constructor method allocates an empty linked list in memory and returns its memory address to the caller. The caller can then call other linked list methods on that linked list.

Several linked list can be created by calling the constructor method several times. A new memory address will be returned to the caller. Beware however not to overwrite an existing linked list address, unless that linked list has been relesed by a previous call to the destructor method.

Prototype

			
     DCTLST_Constructor...
     D                 PR              *
						
Parameters
Return Values


Returns the address of a CTLST instance. This method must be called prior to using CTLST methods. Use this returned address in calls the CTLST methods. Every call to the CTLST_Constructor method will create a new CTLST instance so that you can create as many as are needed.