core.exception

The exception module defines all system-level exceptions and provides a mechanism to alter system-level error handling.

Copyright

Copyright Sean Kelly 2005 - 2013.

License

Boost License 1.0.

Authors

Sean Kelly and Jonathan M Davis

Source: core/_exception.d

var _assertHandler _filterThreadThrowableHandler _nullDerefHandler _store
alias AssertHandler dummy__switch_errorT FilterThreadThrowableHandler NullDerefHandler
class ArrayIndexError ArraySliceError AssertError FinalizeError ForkError InvalidMemoryOperationError InvalidPointerError NullPointerError OutOfMemoryError RangeError SuppressTraceInfo SwitchError UnicodeException
fn __switch_errorT _d_arraybounds _d_arraybounds_index _d_arraybounds_indexp _d_arraybounds_slice _d_arraybounds_slicep _d_arrayboundsp _d_assert _d_assert_msg _d_assertp _d_nullpointerp _d_unittest _d_unittest_msg _d_unittestp assertHandler filterThreadThrowableHandler nullDerefHandler onArrayIndexError onArraySliceError onAssertError onAssertErrorMsg onFinalizeError onForkError onInvalidMemoryOperationError onNullPointerError onRangeError onUnicodeError onUnittestErrorMsg rangeMsgPut staticError

Types 17

private aliasdummy__switch_errorT = __switch_errorT!()
classRangeError : Error

Thrown on a range error.

Constructors
this( string file = __FILE__, size_t line = __LINE__, Throwable next = null )
this( string msg, string file, size_t line, Throwable next = null )
classArrayIndexError : RangeError

Thrown when an out of bounds array index is accessed.

Fields
size_t indexIndex into array
size_t lengthLength of indexed array
private char[100] msgBuf
Constructors
this(size_t index, size_t length, string file = __FILE__, size_t line = __LINE__, Throwable next = null)
classArraySliceError : RangeError

Thrown when an out of bounds array slice is created

Fields
size_t lowerLower/upper bound passed to slice: `array[lower .. upper]`
size_t lengthLength of sliced array
private char[120] msgBuf
Constructors
this(size_t lower, size_t upper, size_t length, string file = __FILE__, size_t line = __LINE__, Throwable next = null)
classAssertError : Error

Thrown on an assert error.

Constructors
this( string file, size_t line )
this( Throwable next, string file = __FILE__, size_t line = __LINE__ )
this( string msg, string file = __FILE__, size_t line = __LINE__, Throwable next = null )
classInvalidPointerError : Error

When an unmapped pointer is accessed this may be thrown via a signal handler.

Constructors
this(string file, size_t line)
this(string file = __FILE__, size_t line = __LINE__, Throwable next = null)
this(string msg, string file = __FILE__, size_t line = __LINE__, Throwable next = null)
classNullPointerError : InvalidPointerError

Thrown when a null dereference may occur.

Depends upon null dereference check, or a signal handler to throw.

Constructors
this(string file, size_t line)
this(string file = __FILE__, size_t line = __LINE__, Throwable next = null)
this(string msg, string file = __FILE__, size_t line = __LINE__, Throwable next = null)
classFinalizeError : Error

Thrown on finalize error.

Fields
TypeInfo info
Methods
string toString() const @safe
Constructors
this( TypeInfo ci, Throwable next, string file = __FILE__, size_t line = __LINE__ )
this( TypeInfo ci, string file = __FILE__, size_t line = __LINE__, Throwable next = null )
classOutOfMemoryError : Error

Thrown on an out of memory error.

Methods
string toString() const @trusted
private string superToString() @trusted
Constructors
this(string file = __FILE__, size_t line = __LINE__, Throwable next = null )
this(bool trace, string file = __FILE__, size_t line = __LINE__, Throwable next = null )
classInvalidMemoryOperationError : Error

Thrown on an invalid memory operation.

An invalid memory operation error occurs in circumstances when the garbage collector has detected an operation it cannot reliably handle. The default D GC is not re-entrant, so this can happen due to allocations done from within finalizers called during a garbage collection cycle.

Methods
string toString() const @trusted
private string superToString() @trusted
Constructors
this(string file = __FILE__, size_t line = __LINE__, Throwable next = null )
classForkError : Error

Thrown on a configuration error.

Constructors
this( string file = __FILE__, size_t line = __LINE__, Throwable next = null )
classSwitchError : Error

Thrown on a switch error.

Constructors
this( string msg, string file = __FILE__, size_t line = __LINE__, Throwable next = null )
classUnicodeException : Exception

Thrown on a unicode conversion error.

Fields
size_t idx
Constructors
this( string msg, size_t idx, string file = __FILE__, size_t line = __LINE__, Throwable next = null )
aliasAssertHandler = void function(string file, size_t line, string msg) nothrow

Gets/sets assert hander. null means the default handler is used.

aliasFilterThreadThrowableHandler = void function(ref Throwable) @system nothrow

Gets/sets the Throwable filter function for threads. null means no handler is called.

aliasNullDerefHandler = void function(string file, size_t line) nothrow

Gets/sets null dereference handler. null means the default handler is used.

classSuppressTraceInfo : Throwable.TraceInfo
Methods
int opApply(scope int delegate(ref const(char[]))) const
int opApply(scope int delegate(ref size_t, ref const(char[]))) const
string toString() const
SuppressTraceInfo instance() static @trusted @nogc pure nothrow

Functions 33

fnvoid __switch_errorT()(string file = __FILE__, size_t line = __LINE__) @trusted
private fnvoid rangeMsgPut(ref char[] r, scope const(char)[] e) @nogc nothrow pure @safeMini `std.range.primitives: put` for constructor of ArraySliceError / ArrayIndexError
fnAssertHandler assertHandler() @property @trusted nothrow @nogcditto
fnvoid assertHandler(AssertHandler handler) @property @trusted nothrow @nogcditto
fnFilterThreadThrowableHandler filterThreadThrowableHandler() @property @trusted nothrow @nogcditto
fnvoid filterThreadThrowableHandler(FilterThreadThrowableHandler handler) @property @trusted nothrow @nogcditto
fnNullDerefHandler nullDerefHandler() @property @trusted nothrow @nogcditto
fnvoid nullDerefHandler(NullDerefHandler handler) @property @trusted nothrow @nogcditto
fnvoid onAssertError( string file = __FILE__, size_t line = __LINE__ ) extern(C) nothrowA callback for assert errors in D. The user-supplied assert handler will be called if one has been supplied, otherwise an AssertError will be thrown.
fnvoid onAssertErrorMsg( string file, size_t line, string msg ) extern(C) nothrowA callback for assert errors in D. The user-supplied assert handler will be called if one has been supplied, otherwise an AssertError will be thrown.
fnvoid onNullPointerError(string file = __FILE__, size_t line = __LINE__) extern(C) nothrowA callback for null dereference errors in D. The user-supplied dereference handler will be called if one has been supplied, otherwise an NullPointerError will be thrown.
fnvoid onUnittestErrorMsg( string file, size_t line, string msg ) extern(C) nothrowA callback for unittest errors in D. The user-supplied unittest handler will be called if one has been supplied, otherwise the error will be written to stderr.
fnnoreturn onRangeError( string file = __FILE__, size_t line = __LINE__ ) extern(C) @trusted pure nothrow @nogcA callback for general array bounds errors in D. A RangeError will be thrown.
fnnoreturn onArraySliceError( size_t lower = 0, size_t upper = 0, size_t length = 0, string file = __FILE__, size_t line = __LINE__ ) extern(C) @trusted pure nothrow @nogcA callback for array slice out of bounds errors in D.
fnnoreturn onArrayIndexError( size_t index = 0, size_t length = 0, string file = __FILE__, size_t line = __LINE__ ) extern(C) @trusted pure nothrow @nogcA callback for array index out of bounds errors in D.
fnnoreturn onFinalizeError( TypeInfo info, Throwable e, string file = __FILE__, size_t line = __LINE__ ) extern(C) @trusted nothrowA callback for finalize errors in D. A FinalizeError will be thrown.
fnnoreturn onInvalidMemoryOperationError(void * pretend_sideffect = null, string file = __FILE__, size_t line = __LINE__) extern(C) @trusted pure nothrow @nogcA callback for invalid memory operations in D. An InvalidMemoryOperationError will be thrown.
fnnoreturn onForkError( string file = __FILE__, size_t line = __LINE__ ) extern(C) @trusted pure nothrow @nogcA callback for errors in the case of a failed fork in D. A ForkError will be thrown.
fnnoreturn onUnicodeError( string msg, size_t idx, string file = __FILE__, size_t line = __LINE__ ) extern(C) @safe pureA callback for unicode errors in D. A UnicodeException will be thrown.
fnvoid _d_assertp(immutable(char) * file, uint line) extern(C)These functions must be defined for any D program linked against this library. Function calls to these are generated by the compiler and inserted into the object code.
fnvoid _d_assert_msg(string msg, string file, uint line) extern(C)
fnvoid _d_assert(string file, uint line) extern(C)
fnvoid _d_unittestp(immutable(char) * file, uint line) extern(C)
fnvoid _d_unittest_msg(string msg, string file, uint line) extern(C)
fnvoid _d_unittest(string file, uint line) extern(C)
fnvoid _d_arrayboundsp(immutable(char *) file, uint line) extern(C)Called when an invalid array index/slice or associative array key is accessed
fnvoid _d_arraybounds(string file, uint line) extern(C)ditto
fnvoid _d_arraybounds_slicep(immutable(char *) file, uint line, size_t lower, size_t upper, size_t length) extern(C)Called when an out of range slice of an array is created
fnvoid _d_arraybounds_slice(string file, uint line, size_t lower, size_t upper, size_t length) extern(C)ditto
fnvoid _d_arraybounds_indexp(immutable(char *) file, uint line, size_t index, size_t length) extern(C)Called when an out of range array index is accessed
fnvoid _d_arraybounds_index(string file, uint line, size_t index, size_t length) extern(C)ditto
fnvoid _d_nullpointerp(immutable(char *) file, uint line) extern(C)
fnT staticError(T, Args...)(auto ref Args args) if (is(T : Error))

Variables 4

private varAssertHandler _assertHandler = null
private varFilterThreadThrowableHandler _filterThreadThrowableHandler = null
private varNullDerefHandler _nullDerefHandler = null
private varvoid[256] _store