Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileobjc_order()
objc_delete()
Object Library
objc_add()                                                              AES

Syntax

WORD objc_add( tree, parent, child )
OBJECT *tree;
WORD parent, child;

Function       objc_add() establishes a child object's relationship to its
               parent.

Opcode         40 (0x28)

Availability   All AES versions.

Parameters     tree specifies the object tree to modify. parent and child
               specify the parent and child object to update.

Binding        intin[0] = parent;
               intin[1] = child;

               addrin[0] = tree;

               return crys_if(0x28);

Return Value   objc_add() returns a 0 if an error occurred or non-zero
               otherwise.

Comments       In order for this function to work, the object to be added
               must be already be a member of the OBJECT array. This
               function simply updates the ob_next, ob_head, and ob_tail
               structure members of OBJECTs in the object tree. These
               fields should be initialized to NIL (0) in the child to be
               added.

See Also       objc_order(), objc_delete()

Group          Object Library