[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
        RL_GetObjectArray - get a pointer to a group of objects (V44)

   SYNOPSIS
        group = RL_GetObjectArray(resource,object,id)
         D0                        A0       A1    D0

        object **rl_getobjectarray(resourcefile, object *, resourceid);

   FUNCTION
        If you allocated an object using rl_newobjecta a lot of additional
        Objects and group of Objects may be allocated automatically. This
        functions returns a pointer to a group of objects with a given group
        ID.

        Never release the group with RL_DisposeGroupA. The group is released
        automatically if the object is released

   INPUTS
        resource -- a pointer to a resource
        object -- a pointer to an object
        id -- a numeric id of a object group

   RESULTS
        group -- a pointer to an array of pointers to object

   SEE ALSO
        resource.library/rl_newobjecta
        resource.library/rl_newgroupa