Package 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	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	Description
String	getStack()	This function returns a decoded version of the getStackFrames() function.
ArrayList<SoErrorStack.StackFrame>	getStackFrames()	Returns the stack frames of the current callback stack.
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, getNativeResourceHandle

Methods inherited from class java.lang.Object

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

Method Details

setHandlerCallback

public static void setHandlerCallback(SoErrorStack.Handler h)

Sets the handler for SoErrorStack class.

getStackFrames

public ArrayList<SoErrorStack.StackFrame> getStackFrames()

Returns the stack frames of the current callback stack. This function is useful to get the stack frames when the custom callback is called.

Returns:

The list of frames in the actual callstack.

post

public static void post()

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

getStack

public String getStack()

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

Returns:

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