BunyipsLib/au.edu.sa.mbhs.studentrobotics.bunyipslib.util/Exceptions

Exceptions

A collection of BunyipsLib global utilities for handling and managing user exceptions.

Provides automatic swallowing of non-critical exceptions while logging to Logcat and the Driver Station, used to "safeguard" the behaviour of user-space code via runUserMethod and handle.

The EmergencyStop exception can be thrown to bypass the capturing nature of this class.

Author

Lucas Bubner, 2025

Since

1.0.0-pre

Types

EmergencyStop

class EmergencyStop : RuntimeException

Custom exception to be thrown when BunyipsLib should end the OpMode following a critical error. This ensures the Exceptions handler will be called but also allows the OpMode to be ended immediately.

Properties

MAX_DS_STACKTRACE_CHARS

@JvmField

var MAX_DS_STACKTRACE_CHARS: Int

Maximum number of characters to display in the stacktrace on the Driver Station.

THROWN_EXCEPTIONS

@JvmField

val THROWN_EXCEPTIONS: MutableSet<Throwable>

Unique exceptions thrown and caught by handle during the execution of the currently executing OpMode.

Functions

getCallingUserCodeFunction

@JvmStatic

fun getCallingUserCodeFunction(): StackTraceElement

Get the calling user code function of the current context by looking at the stacktrace until it leaves BunyipsLib.

handle

@JvmStatic

fun handle(e: Throwable, stderr: Consumer<String>?)

Handle an exception, logging it to the Driver Station and Logcat.

runUserMethod

@JvmStatic

fun runUserMethod(method: Runnable)

Handle and run a single user-controlled method by wrapping the execution with an Exceptions.handle().