An error object contains information that can be used to describe an error that occured in the klisp system. The interpreter will pass an error object to an error continuation whenever it needs to signal that an error occured while executing a program or evaluating an expression.
An error object contains a message describing the situation and a (possibly empty) list of objects, called its irritants, that provide some context or additional info depending on the error condition. The error type is encapsulated.
Notice that unlike in most other languages, the error object in klisp isn't used to classify the error in error handlers, the error continuation being passed the error object is used for that. The error object is used only to convey additional info, not the type of error.
SOURCE NOTE: The type of object passed to the error continuation is not specified in the Kernel Report. This type was inspired by r7rs scheme.
The primitive type predicate for type error.
error-object?returns true iff all the objects in
objectsare of type error.
Create an error object with message
msgand irritants the list of objects
objsand then send that error object to the error continuation. This is the recommended way to signal an error in klisp.
objto the error continuation.
objneeds not be an error object, any kind of object can be sent to the error continuation (but that's not recommended!).
error-object-messageextracts the message of