class Exception

Laufzeitfehlerklasse

Inheritance:


Public

Exceptions erzeugen und zerstören
Exception()
Erzeugen einer neuen Exception ohne Beschreibung
Exception( const String& aDescription )
Erzeugen einer neuen Exception mit einer Beschreibung
virtual ~Exception()
Destruktor
Informationen abfragen
const String toString()
Liefert eine möglichst ausführliche Beschreibung der Fehlermeldung
const String description()
Liefert den Fehlertext der Exception Wenn der Text leer ist, wird 'no description' geliefert
void printOn(ostream& = cout)
Gibt die Exception auf einem Stream aus
Informationen setzen
static void setFileName( const String& fileName )
Setzt den Qelltext-Dateinamen, in dem die Exception erzeugt wurde
void setDescription( const String& description )
Setzt die Beschreibung des Fehlers
static void setLineNumber( int lineNumber )
Setzt die Zeilennummer, in der die Exception erzeugt wurde

Private Fields

String* theDescription
Zeiger auf String mit Fehlermeldung
static String* theFileName
Zeiger auf String mit Dateiname, wo die Exception geworfen wurde
static int theLineNumber
Zeilennummer, in der die Exception geworfen wurde

Documentation

Laufzeitfehlerklasse. Besitzt einen String, der den Fehler beschreibt. Wird die Exception nicht mit dem C++-Schlüsselwort throw, sondern mit throwException() geworfen, kann sie außerdem den Quelltext-Dateinamen und die Zeile, in der sie geworfen wurde, liefern. Hierzu kann entweder toString() oder direkt der Umleitungsoperator << verwendet werden.

Damit Laufzeitfehler auch in der String-Klasse vorkommen können, muß der Fehlerstring als Pointer implementiert sein.

Die Klasse ist zur Vererbung geeignet.

Quelltext

[Header | [Implementierung]

CVS Informationen zum Interface

  **************************************************
  *
  * Aktueller Stand
  *
  *   $RCSfile: Exception.h,v $
  *   $Revision: 1.8 $
  *   $Date: 1998/08/14 13:20:29 $
  *   $Author: myritz $ 
  *
  **************************************************
  
Exceptions erzeugen und zerstören

Exception()
Erzeugen einer neuen Exception ohne Beschreibung

Exception( const String& aDescription )
Erzeugen einer neuen Exception mit einer Beschreibung. Die Beschreibung sollte weder Zeilennummer oder Dateiname enthalten, da diese Daten automatisch beim Aufruf von throwException "erhoben" werden.
Parameters:
aDescription - Eine Beschreibung des Zustandes, der das Programm zum Werfen der Exception veranlaßt hat.

virtual ~Exception()
Destruktor

Informationen setzen

static void setFileName( const String& fileName )
Setzt den Qelltext-Dateinamen, in dem die Exception erzeugt wurde. Wird von throwException aufgerufen.
Parameters:
fileName - Quellcode-Dateiname, der per Konvention bis auf die Endung mit dem Klassennamen übereinstimmt.

void setDescription( const String& description )
Setzt die Beschreibung des Fehlers., in dem die Exception erzeugt wurde. Die Beschreibung sollte weder Zeilennummer oder Dateiname enthalten, da diese Daten automatisch beim Aufruf von throwException "erhoben" werden.
Parameters:
aDescription - Eine Beschreibung des Zustandes, der das Programm zum Werfen der Exception veranlaßt hat.

static void setLineNumber( int lineNumber )
Setzt die Zeilennummer, in der die Exception erzeugt wurde. Wird von throwException aufgerufen.
Parameters:
Die - Zeilennummer in der Quelldatei

Informationen abfragen

const String toString()
Liefert eine möglichst ausführliche Beschreibung der Fehlermeldung. Je nach vorliegenden Informationen wird eine mehr oder weniger ausführliche Meldung erzeugt. Diese Methode ist NICHT virtual. Sie gibt nur das für alle Exceptions gleiche Ausgabeformat aus.

const String description()
Liefert den Fehlertext der Exception Wenn der Text leer ist, wird 'no description' geliefert
Returns:
String mit der Fehlerbeschreibung.

void printOn(ostream& = cout)
Gibt die Exception auf einem Stream aus. Normalerweise wird diese Methode nicht direkt, sondern nur über << aufgerufen.

String* theDescription
Zeiger auf String mit Fehlermeldung.

static String* theFileName
Zeiger auf String mit Dateiname, wo die Exception geworfen wurde

static int theLineNumber
Zeilennummer, in der die Exception geworfen wurde


Direct child classes:
NoCorrespondingPlayerException
IncorrectOldSituationException
NoPlayerWithThisIdException
ModelledObjectException
FailedTriangulationException
FailedPositionCalculationException
InvalidIdException
SensorsException
NothingToSendException
EffectorsException
NothingReceived
CommunicatorException
TimerException
InitFailedException
NoDesiresLeftException
ActionException
VectorException
StringException
ArrayException

alphabetic index hierarchy of classes


Hauptseite

Einleitung | Architektur | Dynamische Zusammenhänge | Referenzhandbuch | FAQ | Anhang A | Anhang B

generated by doc++