exceptionhandling

type INSExceptionHandler ¶

type INSExceptionHandler interface {
	objectivec.IObject

	// Returns a bit mask representing the types of exceptions monitored by the receiver and its handling and logging behavior.
	ExceptionHandlingMask() uint
	// Returns a bit mask representing the types of exceptions that will halt execution for debugging.
	ExceptionHangingMask() uint
	// Sets the bit mask of constants specifying the types of exceptions monitored by the receiver and its handling and logging behavior.
	SetExceptionHandlingMask(aMask uint)
	// Sets the bit mask of constants specifying the types of exceptions that will halt execution for debugging.
	SetExceptionHangingMask(aMask uint)

	// Returns the delegate of the [NSExceptionHandler] object.
	Delegate() objectivec.IObject
	// Sets the delegate of the [NSExceptionHandler] object.
	SetDelegate(anObject objectivec.IObject)
}

An interface definition for the NSExceptionHandler class.

Getting and setting exception masks ¶

• INSExceptionHandler.ExceptionHandlingMask: Returns a bit mask representing the types of exceptions monitored by the receiver and its handling and logging behavior.
• INSExceptionHandler.ExceptionHangingMask: Returns a bit mask representing the types of exceptions that will halt execution for debugging.
• INSExceptionHandler.SetExceptionHandlingMask: Sets the bit mask of constants specifying the types of exceptions monitored by the receiver and its handling and logging behavior.
• INSExceptionHandler.SetExceptionHangingMask: Sets the bit mask of constants specifying the types of exceptions that will halt execution for debugging.

Getting and setting the delegate ¶

• INSExceptionHandler.Delegate: Returns the delegate of the NSExceptionHandler object.
• INSExceptionHandler.SetDelegate: Sets the delegate of the NSExceptionHandler object.

See: https://developer.apple.com/documentation/ExceptionHandling/NSExceptionHandler

type NS ¶

type NS uint32

const (
	// NSHandleOtherExceptionMask: The exception handler handles exceptions caught by handlers lower than the top-level handler by converting them to NSException objects containing a stack trace.
	NSHandleOtherExceptionMask NS = 512
	// NSHandleTopLevelExceptionMask: The exception handler handles exceptions caught by the top-level handler by converting them to NSException objects containing a stack trace.
	NSHandleTopLevelExceptionMask NS = 128
	// NSHandleUncaughtExceptionMask: The exception handler handles uncaught exceptions by terminating the thread in which they occur.
	NSHandleUncaughtExceptionMask NS = 2
	// NSHandleUncaughtRuntimeErrorMask: The exception handler handles uncaught runtime errors by converting them to NSException objects containing a stack trace.
	NSHandleUncaughtRuntimeErrorMask NS = 32
	// NSHandleUncaughtSystemExceptionMask: The exception handler handles uncaught system exceptions by converting them to NSException objects containing a stack trace.
	NSHandleUncaughtSystemExceptionMask NS = 8
	// NSLogOtherExceptionMask: The exception handler logs exceptions caught by handlers lower than the top-level handler.
	NSLogOtherExceptionMask NS = 256
	// NSLogTopLevelExceptionMask: The exception handler logs exceptions that would be caught by the top-level handler.
	NSLogTopLevelExceptionMask NS = 64
	// NSLogUncaughtExceptionMask: The exception handler logs uncaught exceptions.
	NSLogUncaughtExceptionMask NS = 1
	// NSLogUncaughtRuntimeErrorMask: The exception handler logs uncaught runtime errors.
	NSLogUncaughtRuntimeErrorMask NS = 16
	// NSLogUncaughtSystemExceptionMask: The exception handler logs uncaught system exceptions.
	NSLogUncaughtSystemExceptionMask NS = 4
)

func (e NS) String() string

type NSExceptionHandler ¶

type NSExceptionHandler struct {
	objectivec.Object
}

The NSExceptionHandler class provides facilities for monitoring and debugging exceptional conditions in Objective-C programs. It works by installing a special uncaught exception handler via the NSSetUncaughtExceptionHandler(_:) function. Consequently, to use the services of NSExceptionHandler, you must not install your own custom uncaught exception handler.

Overview ¶

To use these services, you set a bit mask in the singleton NSExceptionHandler instance and, optionally, a delegate. The constants comprising the bit mask indicate the type of exception to be monitored and the behavior of the NSExceptionHandler object (or, simply, the exception handler). The delegate is asked to approve the logging and handling of each monitored NSException object using the NSExceptionHandlerDelegate protocol.

The constants for configuring exception handler behavior can be categorized in several ways:

- Uncaught exceptions versus caught exceptions—or, more accurately, exceptions that would be caught (for example, by the top-level handler) - Exception type or cause: system exceptions (such as invalid memory accesses), Objective-C runtime errors (such as messages sent to freed objects), and other exceptions - Exception handler behavior: logging the exception (including a stack trace) to the console, handling the exception, and suspending program execution so the debugger can be attached

The way the exception handler handles an exception depends on the type of exception; the exception handler converts system exceptions and runtime errors into NSException objects with a stack trace embedded in their `userInfo` dictionary; for all other uncaught exceptions, it terminates the thread on which they occur . The constants used to configure an NSExceptionHandler object are described in Logging and Handling Constants and System Hang Constants.

The `defaults` command-line system also allows you to set values corresponding to the `enum` constants used to configure the exception handler; see Controlling a Program’s Response to Exceptions for details.

Getting and setting exception masks ¶

• NSExceptionHandler.ExceptionHandlingMask: Returns a bit mask representing the types of exceptions monitored by the receiver and its handling and logging behavior.
• NSExceptionHandler.ExceptionHangingMask: Returns a bit mask representing the types of exceptions that will halt execution for debugging.
• NSExceptionHandler.SetExceptionHandlingMask: Sets the bit mask of constants specifying the types of exceptions monitored by the receiver and its handling and logging behavior.
• NSExceptionHandler.SetExceptionHangingMask: Sets the bit mask of constants specifying the types of exceptions that will halt execution for debugging.

Getting and setting the delegate ¶

• NSExceptionHandler.Delegate: Returns the delegate of the NSExceptionHandler object.
• NSExceptionHandler.SetDelegate: Sets the delegate of the NSExceptionHandler object.

See: https://developer.apple.com/documentation/ExceptionHandling/NSExceptionHandler

func NSExceptionHandlerFromID(id objc.ID) NSExceptionHandler

func NewNSExceptionHandler() NSExceptionHandler

func (e NSExceptionHandler) Autorelease() NSExceptionHandler

func (e NSExceptionHandler) Delegate() objectivec.IObject

func (e NSExceptionHandler) ExceptionHandlingMask() uint

func (e NSExceptionHandler) ExceptionHangingMask() uint

func (e NSExceptionHandler) Init() NSExceptionHandler

func (e NSExceptionHandler) SetDelegate(anObject objectivec.IObject)

func (e NSExceptionHandler) SetExceptionHandlingMask(aMask uint)

func (e NSExceptionHandler) SetExceptionHangingMask(aMask uint)

type NSExceptionHandlerClass ¶

type NSExceptionHandlerClass struct {
	// contains filtered or unexported fields
}

func GetNSExceptionHandlerClass() NSExceptionHandlerClass

func (nc NSExceptionHandlerClass) Alloc() NSExceptionHandler

func (nc NSExceptionHandlerClass) Class() objc.Class

func (_NSExceptionHandlerClass NSExceptionHandlerClass) DefaultExceptionHandler() NSExceptionHandler

type NSHangOn ¶

type NSHangOn uint32

const (
	// NSHangOnOtherExceptionMask: The exception handler suspends execution when it detects an exception that would be handled by an object other than the top-level handler.
	NSHangOnOtherExceptionMask NSHangOn = 16
	// NSHangOnTopLevelExceptionMask: The exception handler suspends execution when it detects an exception that would be handled by the top-level handler.
	NSHangOnTopLevelExceptionMask NSHangOn = 8
	// NSHangOnUncaughtExceptionMask: The exception handler suspends execution when it detects an uncaught exception (other than a system exception or runtime error).
	NSHangOnUncaughtExceptionMask NSHangOn = 1
	// NSHangOnUncaughtRuntimeErrorMask: The exception handler suspends execution when it detects an uncaught runtime error.
	NSHangOnUncaughtRuntimeErrorMask NSHangOn = 4
	// NSHangOnUncaughtSystemExceptionMask: The exception handler suspends execution when it detects an uncaught system exception.
	NSHangOnUncaughtSystemExceptionMask NSHangOn = 2
)

func (e NSHangOn) String() string