/*
* @(#)exceptions.h 1.8 95/01/31
*
* Copyright (c) 1994 Sun Microsystems, Inc. All Rights Reserved.
*
* Permission to use, copy, modify, and distribute this software
* and its documentation for NON-COMMERCIAL purposes and without
* fee is hereby granted provided that this copyright notice
* appears in all copies. Please refer to the file "copyright.html"
* for further important copyright and licensing information.
*
* SUN MAKES NO REPRESENTATIONS OR WARRANTIES ABOUT THE SUITABILITY OF
* THE SOFTWARE, EITHER EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
* TO THE IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A
* PARTICULAR PURPOSE, OR NON-INFRINGEMENT. SUN SHALL NOT BE LIABLE FOR
* ANY DAMAGES SUFFERED BY LICENSEE AS A RESULT OF USING, MODIFYING OR
* DISTRIBUTING THIS SOFTWARE OR ITS DERIVATIVES.
*/
/*
* The Java runtime exception handling mechanism.
*/
#ifndef _EXCEPTIONS_H_
#define _EXCEPTIONS_H_
/*
* Header files.
*/
#include "oobj.h"
#include "javaThreads.h"
/*
* Type definitions.
*/
/*
* Exceptions, as defined in the Java93 spec, are subclasses of Object.
*
* The list of exceptions thrown by the runtime and other commonly
* used classes can be found in StandardDefs.gt.
*/
typedef JHandle *exception_t;
/*
* The exception mechanism has a set of preallocated exception objects
* that can be thrown in the face of utter confusion and system meltdown.
* internal_exception_t enumerates these objects.
*/
typedef enum {
IEXC_NONE, /* A null object */
IEXC_NoClassDefinitionFound,
IEXC_OutOfMemory,
IEXC_END /* Keep this last */
} internal_exception_t;
/*
* External routines.
*/
/*
* exceptionInit() -- Initialize the exception subsystem.
*/
extern void exceptionInit(void);
/*
* exceptionInternalObject() -- Return an internal, preallocated
* exception object. These are shared by all threads, so they
* should only be used in a last ditch effort.
*/
extern JHandle *exceptionInternalObject(internal_exception_t exc);
/*
* exceptionDescribe() -- Print out a description of a given exception
* object.
*/
extern void exceptionDescribe(struct execenv *ee);
#endif /* !_EXCEPTIONS_H_ */