123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548 |
|
/**
* The exception module defines all system-level exceptions and provides a
* mechanism to alter system-level error handling.
*
* Copyright: Copyright (C) 2005-2006 Sean Kelly, Kris Bell. All rights reserved.
* License: BSD style: $(LICENSE)
* Authors: Sean Kelly, Kris Bell
*/
module tango.core.Exception;
version = SocketSpecifics; // TODO: remove this before v1.0
private
{
alias void function( char[] file, size_t line, char[] msg = null ) assertHandlerType;
assertHandlerType assertHandler = null;
}
////////////////////////////////////////////////////////////////////////////////
/*
- Exception
- OutOfMemoryException
- SwitchException
- AssertException
- ArrayBoundsException
- FinalizeException
- PlatformException
- ProcessException
- ThreadException
- FiberException
- SyncException
- IOException
- SocketException
- VfsException
- ClusterException
- NoSuchElementException
- CorruptedIteratorException
- IllegalArgumentException
- IllegalElementException
- TextException
- XmlException
- RegexException
- LocaleException
- UnicodeException
- PayloadException
*/
////////////////////////////////////////////////////////////////////////////////
/**
* Thrown on an out of memory error.
*/
class OutOfMemoryException : Exception
{
this( char[] file, long line )
{
super( "Memory allocation failed", file, line );
}
char[] toString()
{
return msg ? super.toString() : "Memory allocation failed";
}
}
/**
* Base class for operating system or library exceptions.
*/
class PlatformException : Exception
{
this( char[] msg )
{
super( msg );
}
}
/**
* Thrown on an assert error.
*/
class AssertException : Exception
{
this( char[] file, long line )
{
super( "Assertion failure", file, line );
}
this( char[] msg, char[] file, long line )
{
super( msg, file, line );
}
}
/**
* Thrown on an array bounds error.
*/
class ArrayBoundsException : Exception
{
this( char[] file, long line )
{
super( "Array index out of bounds", file, line );
}
}
/**
* Thrown on finalize error.
*/
class FinalizeException : Exception
{
ClassInfo info;
this( ClassInfo c, Exception e )
{
super( "Finalization error", e );
info = c;
}
override char[] toString()
{
auto other = super.next ? super.next.toString : "unknown";
return "An exception was thrown while finalizing an instance of class " ~ info.name ~ " :: "~other;
}
}
/**
* Thrown on a switch error.
*/
class SwitchException : Exception
{
this( char[] file, long line )
{
super( "No appropriate switch clause found", file, line );
}
}
/**
* Represents a text processing error.
*/
class TextException : Exception
{
this( char[] msg )
{
super( msg );
}
}
/**
* Thrown on a unicode conversion error.
*/
class UnicodeException : TextException
{
size_t idx;
this( char[] msg, size_t idx )
{
super( msg );
this.idx = idx;
}
}
/**
* Base class for thread exceptions.
*/
class ThreadException : PlatformException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Base class for fiber exceptions.
*/
class FiberException : ThreadException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Base class for synchronization exceptions.
*/
class SyncException : PlatformException
{
this( char[] msg )
{
super( msg );
}
}
/**
* The basic exception thrown by the tango.io package. One should try to ensure
* that all Tango exceptions related to IO are derived from this one.
*/
class IOException : PlatformException
{
this( char[] msg )
{
super( msg );
}
}
/**
* The basic exception thrown by the tango.io.vfs package.
*/
class VfsException : IOException
{
this( char[] msg )
{
super( msg );
}
}
/**
* The basic exception thrown by the tango.io.cluster package.
*/
class ClusterException : IOException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Base class for socket exceptions.
*/
class SocketException : IOException
{
this( char[] msg )
{
super( msg );
}
}
version (SocketSpecifics)
{
/**
* Base class for exception thrown by an InternetHost.
*/
class HostException : IOException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Base class for exceptiond thrown by an Address.
*/
class AddressException : IOException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Thrown when a socket failed to accept an incoming connection.
*/
class SocketAcceptException : SocketException
{
this( char[] msg )
{
super( msg );
}
}
}
/**
* Thrown on a process error.
*/
class ProcessException : PlatformException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Base class for regluar expression exceptions.
*/
class RegexException : TextException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Base class for locale exceptions.
*/
class LocaleException : TextException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Base class for XML exceptions.
*/
class XmlException : TextException
{
this( char[] msg )
{
super( msg );
}
}
/**
* RegistryException is thrown when the NetworkRegistry encounters a
* problem during proxy registration, or when it sees an unregistered
* guid.
*/
class RegistryException : Exception
{
this( char[] msg )
{
super( msg );
}
}
/**
* Thrown when an illegal argument is encountered.
*/
class IllegalArgumentException : Exception
{
this( char[] msg )
{
super( msg );
}
}
/**
*
* IllegalElementException is thrown by Collection methods
* that add (or replace) elements (and/or keys) when their
* arguments are null or do not pass screeners.
*
*/
class IllegalElementException : IllegalArgumentException
{
this( char[] msg )
{
super( msg );
}
}
/**
* Thrown on past-the-end errors by iterators and containers.
*/
class NoSuchElementException : Exception
{
this( char[] msg )
{
super( msg );
}
}
/**
* Thrown when a corrupt iterator is detected.
*/
class CorruptedIteratorException : NoSuchElementException
{
this( char[] msg )
{
super( msg );
}
}
////////////////////////////////////////////////////////////////////////////////
// Overrides
////////////////////////////////////////////////////////////////////////////////
/**
* Overrides the default assert hander with a user-supplied version.
*
* Params:
* h = The new assert handler. Set to null to use the default handler.
*/
void setAssertHandler( assertHandlerType h )
{
assertHandler = h;
}
////////////////////////////////////////////////////////////////////////////////
// Overridable Callbacks
////////////////////////////////////////////////////////////////////////////////
/**
* A callback for assert errors in D. The user-supplied assert handler will
* be called if one has been supplied, otherwise an AssertException will be
* thrown.
*
* Params:
* file = The name of the file that signaled this error.
* line = The line number on which this error occurred.
*/
extern (C) void onAssertError( char[] file, size_t line )
{
if( assertHandler is null )
throw new AssertException( file, cast(long)line );
assertHandler( file, line );
}
/**
* A callback for assert errors in D. The user-supplied assert handler will
* be called if one has been supplied, otherwise an AssertException will be
* thrown.
*
* Params:
* file = The name of the file that signaled this error.
* line = The line number on which this error occurred.
* msg = An error message supplied by the user.
*/
extern (C) void onAssertErrorMsg( char[] file, size_t line, char[] msg )
{
if( assertHandler is null )
throw new AssertException( msg, file, cast(long)line );
assertHandler( file, line, msg );
}
////////////////////////////////////////////////////////////////////////////////
// Internal Error Callbacks
////////////////////////////////////////////////////////////////////////////////
/**
* A callback for array bounds errors in D. An ArrayBoundsException will be
* thrown.
*
* Params:
* file = The name of the file that signaled this error.
* line = The line number on which this error occurred.
*
* Throws:
* ArrayBoundsException.
*/
extern (C) void onArrayBoundsError( char[] file, size_t line )
{
throw new ArrayBoundsException( file, cast(long)line );
}
/**
* A callback for finalize errors in D. A FinalizeException will be thrown.
*
* Params:
* e = The exception thrown during finalization.
*
* Throws:
* FinalizeException.
*/
extern (C) void onFinalizeError( ClassInfo info, Exception ex )
{
throw new FinalizeException( info, ex );
}
/**
* A callback for out of memory errors in D. An OutOfMemoryException will be
* thrown.
*
* Throws:
* OutOfMemoryException.
*/
extern (C) void onOutOfMemoryError()
{
// NOTE: Since an out of memory condition exists, no allocation must occur
// while generating this object.
throw cast(OutOfMemoryException) cast(void*) OutOfMemoryException.classinfo.init;
}
/**
* A callback for switch errors in D. A SwitchException will be thrown.
*
* Params:
* file = The name of the file that signaled this error.
* line = The line number on which this error occurred.
*
* Throws:
* SwitchException.
*/
extern (C) void onSwitchError( char[] file, size_t line )
{
throw new SwitchException( file, cast(long)line );
}
/**
* A callback for unicode errors in D. A UnicodeException will be thrown.
*
* Params:
* msg = Information about the error.
* idx = String index where this error was detected.
*
* Throws:
* UnicodeException.
*/
extern (C) void onUnicodeError( char[] msg, size_t idx )
{
throw new UnicodeException( msg, idx );
}
|