Module qilletni.api

Package dev.qilletni.api.lang.stack

Interface QilletniStackTrace

public interface QilletniStackTrace

The internal call stack of a Qilletni program. This only counts Qilletni methods, and not the Java stack trace that may be populated in a native method.

Method Summary

Modifier and Type	Method	Description
QilletniStackTrace	cloneStackTrace()	Clones the stack trace at its current point.
String	displayStackTrace()	Puts the stack trace contents into a displayable string.
List<QilletniStackTraceElement>	getStackTrace()	Gets the current stack trace as a list of elements.
void	popStackTraceElement()	Removes the top stack trace element, when a function is exited.
void	pushStackTraceElement(QilletniStackTraceElement stackTraceElement)	Adds a stack trace element to the top of the stack, signifying a Qilletni method has been invoked (or some other significant flow change).

Method Details

pushStackTraceElement

void pushStackTraceElement(QilletniStackTraceElement stackTraceElement)

Adds a stack trace element to the top of the stack, signifying a Qilletni method has been invoked (or some other significant flow change).

Parameters:

stackTraceElement - The element to push, identifying the call

popStackTraceElement

void popStackTraceElement()

Removes the top stack trace element, when a function is exited.

getStackTrace

List<QilletniStackTraceElement> getStackTrace()

Gets the current stack trace as a list of elements.

Returns:

The stack trace

displayStackTrace

String displayStackTrace()

Puts the stack trace contents into a displayable string.

Returns:

The string representing the whole stack trace

cloneStackTrace

QilletniStackTrace cloneStackTrace()

Clones the stack trace at its current point. This is used for splitting flow control, in the case of invoking functions from native methods.

Returns:

The cloned stack trace