company logo

CTX_Base :: ExecuteFunction - Execute context function

The function provides a C++/OSI interface to the dynamic class library. Typically, the function provides an interface to a context class. When the requested function could not be found, the function returns -1 (not executed). In case of an error, the function returns 1 (error). When being processed successfully, the function returns 0 (no error).

Return value:   - internal feature (not documented) ( int8  )

Implementation details

int8 CTX_Base  :: ExecuteFunction ( char *fname, logical chk_opt=NO )

Functions in the dynamic class library have to be defined with following signature:

public: virtual char ExecuteFunction(const char *, unsigned char);

The search sequence for context functions (actions or OSI expressions implemented in context classes) is as follows:

  1. User implemented context class hierarchy
  2. OSI context class functions
  3. Default context actions


  • fname - Function name

    The function name is passed as 0-terminated string with a maximum length of 40 characters.

    Notes:

    must be C string

  • chk_opt - Check option

    The option forces the function to check the property handle before running executing the function. You can pass NO to avoid unnecessary checking.

    Default: NO