Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.16.1  objc_add                                                   TOS

 Name:         »Object add« - Insert object in an object tree.

 Opcode:       40

 Syntax:       int16_t objc_add ( OBJECT *ob_atree, int16_t 
               ob_aparent, int16_t ob_achild );

 Description:  The call objc_add creates a hierarchical connection 
               between two objects in an object tree - in other words 
               extablishes the relationship of a child object to its 
               parent. The following apply:

                Parameter  Meaning

                ob_atree   Address of the relevant object tree
                ob_aparent Index of the object to which the child is 
                           to be added
                ob_achild  Index of the child, i.e. of the object to 
                           be added

               (Note: At insertion, the components ob_head and ob_tail 
               of the OBJECT structure must already have been suitably 
               initialized and be part of the OBJECT array.

 Return value: An error has arisen only if the value 0 is returned.

 Availability: All AES versions.

 Group:        Object library

 Querverweise: Binding   OBJECT   objc_delete