OMXgroup::ret_omx_ptr


Synopsis


void *OMXgroup::ret_omx_ptr( const char  *class_name);

Description

OMXgroup::ret_omx_ptr casts the object whose method is being called to a pointer to an object of the class specified by the class_name argument. Calling this routine


class_name *my_ptr;
my_ptr = (my_class *)my_grp->ret_omx_ptr("my_class");

is similar to the C++ construct


class_name *my_ptr = (class_name *) my_grp;

You cannot simply use the C++ construct because classes generated with the C++ API use virtual classes. In C++ you cannot cast from a virtual base class to a subclass.

Arguments

class_name

A NULL terminated string specifying the class name of the class you want returned. This class name must be the name of a class in this object's definition or a NULL pointer is returned.

Returned value

This routine returns a void * that you can then cast to the class specified by the class_name argument.