com.openinventor.inventor.errors

Class SoErrorStack

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.errors.SoError

com.openinventor.inventor.errors.SoErrorStack

public class SoErrorStack
extends SoError

Stack debugging handler. SoErrorStack is used to obtain and/or report the program callstack.

The post() method gets the actual callstack and calls a custom callback, if one is defined, else it dumps the callstack using SoDebugError.

It is also possible to allow SoStackError to automaticaly report the callstack, when a signal is reported by the system, by setting OIV_DEBUG_STACKERROR to 1.

See also:

SoReadError

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static interface	SoErrorStack.Handler
static class	SoErrorStack.StackFrame This struture contains the description of a stack frame.

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Method Summary

Modifier and Type	Method and Description
java.lang.String	getStack() This function returns a decoded version of the getStackFrames() function.
static void	post() Posts the current callstack to the application callback or to SoDebugError if the custom callback was not specified.
static void	setHandlerCallback(SoErrorStack.Handler h) Sets the handler for SoErrorStack class.

Methods inherited from class com.openinventor.inventor.errors.SoError

getDebugString, post, setHandlerCallback

Methods inherited from class com.openinventor.inventor.Inventor

dispose, getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

setHandlerCallback

public static void setHandlerCallback(SoErrorStack.Handler h)

Sets the handler for SoErrorStack class.

getStack

public java.lang.String getStack()

This function returns a decoded version of the getStackFrames() function.

Returns:

A string which contains a human readable version of the stack.

post

public static void post()

Posts the current callstack to the application callback or to SoDebugError if the custom callback was not specified.