Previous: Condition State, Up: Condition Instances
The simple procedures described in this section are built on top of the more detailed abstraction of condition objects described above. While these procedures are sometimes easier to use, they are often less efficient.
Create a new condition object as an instance of condition-type, associated with continuation. The continuation is provided for inspection purposes only, not for restarting the computation. The restarts argument is described in Restarts. The field-plist is an alternating list of field names and values for those fields, where the field names are those that would be returned by
(condition-type/field-names
condition-type)
. It is used to provide values for fields in the condition object; fields with no value specified are set to#f
. Once a condition object has been created there is no way to alter the values of these fields.
Returns the value stored in the field field-name within condition. Field-name must be one of the names returned by
(condition-type/field-names (condition/type
condition))
.access-condition
looks up the field-name at runtime, so it is more efficient to usecondition-accessor
to create an access function if the same field is to be extracted from several instances of the same condition type.