objectstore_exception::signal()
void signal([os_int32 value,] char const *format ...);Signals the TIX exception for which the function is called. The first argument is optional. It is used to associate an error code with the signaling of the exception. The value can be retrieved with the function tix_handler::get_value(). The subsequent arguments work as with the function printf(). A format string is supplied, followed by any number of additional arguments. Control is transferred to the most recently established handler for the exception or one of its parents and the message supplied in the format string is ignored. If there is no such handler, the exception's associated message is issued, together with the message specified by format and associated arguments. The session is then aborted or exited from, as determined by the environment variable OS_DEF_EXCEPT_ACTION (see Managing ObjectStore).
For information about the macros that are used to establish TIX exception handlers, see Chapter 4, System-Supplied Macros.
objectstore_exception::vsignal()
void vsignal([os_int32 value,] char const *format, va_list args);Signals the TIX exception for which the function is called. The first argument is optional. It is used to associate an error code with the signaling of the exception. The value can be retrieved with the function tix_handler::get_value(). The subsequent arguments work as with the function vprintf(). A format string is supplied, followed by a va_list. Control is transferred to the most recently established handler for the exception or one of its parents and the message supplied in the format string is ignored. If there is no such handler, the exception's associated message is issued, along with the message specified by format and associated arguments. The session is then aborted or exited from, as determined by the environment variable OS_DEF_EXCEPT_ACTION (see Managing ObjectStore).
For information about the macros that are used to establish TIX exception handlers, see Chapter 4, System-Supplied Macros.
Updated: 03/15/99 16:41:22