Ada Programming/Exceptions< Ada Programming
- 1 Robustness
- 2 Modules, preconditions and postconditions
- 3 Predefined exceptions
- 4 Input-output exceptions
- 5 Exception declarations
- 6 Exception handlers
- 7 Raising exceptions
- 8 Exception handling and propagation
- 9 Information about an exception occurrence
- 10 See also
Robustness is the ability of a system or system component to behave “reasonably” when it detects an anomaly, e.g.:
- It receives invalid inputs.
- Another system component (hardware or software) malfunctions.
Take as example a telephone exchange control program. What should the control program do when a line fails? It is unacceptable simply to halt — all calls will then fail. Better would be to abandon the current call (only), record that the line is out of service, and continue. Better still would be to try to reuse the line — the fault might be transient. Robustness is desirable in all systems, but it is essential in systems on which human safety or welfare depends, e.g., hospital patient monitoring, aircraft fly-by-wire, nuclear power station control, etc.
Modules, preconditions and postconditionsEdit
A module may be specified in terms of its preconditions and postconditions. A precondition is a condition that the module’s inputs are supposed to satisfy. A postcondition is a condition that the module’s outputs are required to satisfy, provided that the precondition is satisfied. What should a module do if its precondition is not satisfied?
- Halt? Even with diagnostic information, this is generally unacceptable.
- Use a global result code? The result code can be set to indicate an anomaly. Subsequently it may be tested by a module that can effect error recovery. Problem: this induces tight coupling among the modules concerned.
- Each module has its own result code? This is a parameter (or function result) that may be set to indicate an anomaly, and is tested by calling modules. Problems: (1) setting and testing result codes tends to swamp the normal-case logic and (2) the result codes are normally ignored.
- Exception handling — Ada’s solution. A module detecting an anomaly raises an exception. The same, or another, module may handle that exception.
The exception mechanism permits clean, modular handling of anomalous situations:
- A unit (e.g., block or subprogram body) may raise an exception, to signal that an anomaly has been detected. The computation that raised the exception is abandoned (and can never be resumed, although it can be restarted).
- A unit may propagate an exception that has been raised by itself (or propagated out of another unit it has called).
- A unit may alternatively handle such an exception, allowing programmer-defined recovery from an anomalous situation. Exception handlers are segregated from normal-case code.
The predefined exceptions are those defined in package Standard. Every language-defined run-time error causes a predefined exception to be raised. Some examples are:
- Constraint_Error, raised when a subtype’s constraint is not satisfied
- Program_Error, when a protected operation is called inside a protected object, e.g.
- Storage_Error, raised by running out of storage
- Tasking_Error, when a task cannot be activated because the operating system has not enough resources, e.g.
Name : String (1 .. 10); ... Name := "Hamlet"; -- Raises Constraint_Error, -- because the "Hamlet" has bounds (1 .. 6).
loop P := new Int_Node'(0, P); end loop; -- Soon raises Storage_Error, -- because of the extreme memory leak.
Ex.3 Compare the following approaches:
procedure Compute_Sqrt (X : in Float; Sqrt : out Float; OK : out Boolean) is begin if X >= 0 then OK := True; -- compute √X ... else OK := False; end if; end Compute_Sqrt; ... procedure Triangle (A, B, C : in Float; Area, Perimeter : out Float; Exists : out Boolean) is S : constant Float := 0.5 * (A + B + C); OK : Boolean; begin Compute_Sqrt (S * (S-A) * (S-B) * (S-C), Area, OK); Perimeter := 2.0 * S; Exists := OK; end Triangle;
A negative argument to Compute_Sqrt causes OK to be set to False. Triangle uses it to determine its own status parameter value, and so on up the calling tree, ad nauseam.
function Sqrt (X : Float) return Float is begin if X < 0.0 then raise Constraint_Error; end if; -- compute √X ... end Sqrt; ... procedure Triangle (A, B, C : in Float; Area, Perimeter : out Float) is S: constant Float := 0.5 * (A + B + C); begin Area := Sqrt (S * (S-A) * (S-B) * (S-C)); Perimeter := 2.0 * S; end Triangle;
A negative argument to Sqrt causes Constraint_Error to be explicitly raised inside Sqrt, and propagated out. Triangle simply propagates the exception (by not handling it).
Alternatively, we can catch the error by using the type system:
subtype Pos_Float is Float range 0.0 .. Float'Last; function Sqrt (X : Pos_Float) return Pos_Float is begin -- compute √X ... end Sqrt;
A negative argument to Sqrt now raises Constraint_Error at the point of call. Sqrt is never even entered.
Some examples of exceptions raised by subprograms of the predefined package Ada.Text_IO are:
- End_Error, raised by Get, Skip_Line, etc., if end-of-file already reached.
- Data_Error, raised by Get in Integer_IO, etc., if the input is not a literal of the expected type.
- Mode_Error, raised by trying to read from an output file, or write to an input file, etc.
- Layout_Error, raised by specifying an invalid data format in a text I/O operation
Exceptions are declared similarly to objects.
Ex.1 declares two exceptions:
Line_Failed, Line_Closed: exception;
However, exceptions are not objects. For example, recursive re-entry to a scope where an exception is declared does not create a new exception of the same name; instead the exception declared in the outer invocation is reused.
When an exception occurs, the normal flow of execution is abandoned and the exception is handed up the call sequence until a matching handler is found. Any declarative region (except a package specification) can have a handler. The handler names the exceptions it will handle. By moving up the call sequence, exceptions can become anonymous; in this case, they can only be handled be the others handler.
function F return Some_Type is ... -- declations (1) begin ... -- statements (2) exception -- handlers start here (3) when Name_1 | Name_2 => ... -- The named exceptions are handled with these statements when others => ... -- any other exceptions (also anonymous ones) are handled here end F;
Exceptions raised in the declarative region itself (1) cannot be handled by handlers of this region (3); they can only be handled in outer scopes. Exceptions raised in the sequence of statements (2) can of course be handled at (3).
The reason for this rule is so that the handler can assume that any items declared in the declarative region (1) are well defined and may be referenced. If the handler at (3) could handle exceptions raised at (1), it would be unknown which items existed and which ones didn't.
The raise statement explicitly raises a specified exception.
package body Directory_Enquiries is procedure Insert (New_Name : in Name; New_Number : in Number) is … begin … if New_Name = Old_Entry.A_Name then raise Name_Duplicated; end if; … New_Entry := new Dir_Node'(New_Name, New_Number,…); … exception when Storage_Error => raise Directory_Full; end Insert; procedure Lookup (Given_Name : in Name; Corr_Number : out Number) is … begin … if not Found then raise Name_Absent; end if; … end Lookup; end Directory_Enquiries;
Exception handling and propagationEdit
Exception handlers may be grouped at the end of a block, subprogram body, etc. A handler is any sequence of statements that may end:
- by completing;
- by executing a return statement;
- by raising a different exception (raise e;);
- by re-raising the same exception (raise;).
Suppose that an exception e is raised in a sequence of statements U (a block, subprogram body, etc.).
- If U contains a handler for e: that handler is executed, then control leaves U.
- If U contains no handler for e: e is propagated out of U; in effect, e is raised at the "point of call” of U.
So the raising of an exception causes the sequence of statements responsible to be abandoned at the point of occurrence of the exception. It is not, and cannot be, resumed.
Information about an exception occurrenceEdit
Ada provides information about an exception in an object of type Exception_Occurrence, defined in Ada.Exceptions along with subprograms taking this type as parameter:
- Exception_Name: return the full exception name using the dot notation and in uppercase letters. For example, Queue.Overflow.
- Exception_Message: return the exception message associated with the occurrence.
- Exception_Information: return a string including the exception name and the associated exception message.
For getting an exception occurrence object the following syntax is used:
with Ada.Exceptions; use Ada.Exceptions; ... exception when Error: High_Pressure | High_Temperature => Put ("Exception: "); Put_Line (Exception_Name (Error)); Put (Exception_Message (Error)); when Error: others => Put ("Unexpected exception: "); Put_Line (Exception_Information(Error)); end;
The exception message content is implementation defined when it is not set by the user who raises the exception. It usually contains a reason for the exception and the raising location.
The user can specify a message using the procedure Raise_Exception.
declare Valve_Failure : exception; begin ... Raise_Exception (Valve_Failure'Identity, "Failure while opening"); ... Raise_Exception (Valve_Failure'Identity, "Failure while closing"); ... exception when Fail: Valve_Failure => Put (Exception_Message (Fail)); end;
Starting with Ada 2005, a simpler syntax can be used to associate a string message with exception occurrence.
-- This language feature is only available in Ada 2005. declare Valve_Failure : exception; begin ... raise Valve_Failure with "Failure while opening"; ... raise Valve_Failure with "Failure while closing"; ... exception when Fail: Valve_Failure => Put (Exception_Message (Fail)); end;
The Ada.Exceptions package also provides subprograms for saving exception occurrences and re-raising them.
Ada 95 Reference ManualEdit
Ada 2005 Reference ManualEdit
Ada Quality and Style GuideEdit
- Chapter 4: Program Structure
- Chapter 5: Programming Practices