runtime/objc-exception.h

   1 /*
   2  * Copyright (c) 1999 Apple Computer, Inc. All rights reserved.
   3  *
   4  * @APPLE_LICENSE_HEADER_START@
   5  *
   6  * Copyright (c) 1999-2003 Apple Computer, Inc.  All Rights Reserved.
   7  *
   8  * This file contains Original Code and/or Modifications of Original Code
   9  * as defined in and that are subject to the Apple Public Source License
  10  * Version 2.0 (the 'License'). You may not use this file except in
  11  * compliance with the License. Please obtain a copy of the License at
  12  * http://www.opensource.apple.com/apsl/ and read it before using this
  13  * file.
  14  *
  15  * The Original Code and all software distributed under the License are
  16  * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER
  17  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
  18  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
  19  * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT.
  20  * Please see the License for the specific language governing rights and
  21  * limitations under the License.
  22  *
  23  * @APPLE_LICENSE_HEADER_END@
  24  */
  25
  26 //  objc_exception.h
  27 //  Support for Objective-C language Exceptions
  28 //
  29 //  Created by Blaine Garst on Fri Nov 01 2002.
  30 //  Copyright (c) 2002-3 Apple Computer, Inc. All rights reserved.
  31 //
  32
  33 #ifndef __OBJC_EXCEPTION_H_
  34 #define __OBJC_EXCEPTION_H_
  35
  36 #import "objc/objc-class.h"
  37
  38 // compiler reserves a setjmp buffer + 4 words as localExceptionData
  39
  40 OBJC_EXPORT void objc_exception_throw(id exception);
  41 OBJC_EXPORT void objc_exception_try_enter(void *localExceptionData);
  42 OBJC_EXPORT void objc_exception_try_exit(void *localExceptionData);
  43 OBJC_EXPORT id objc_exception_extract(void *localExceptionData);
  44 OBJC_EXPORT int objc_exception_match(Class exceptionClass, id exception);
  45
  46
  47 typedef struct {
  48     int version;
  49     void (*throw_exc)(id);              // version 0
  50     void (*try_enter)(void *);  // version 0
  51     void (*try_exit)(void *);   // version 0
  52     id   (*extract)(void *);    // version 0
  53     int (*match)(Class, id);    // version 0
  54 }
  55     objc_exception_functions_t;
  56
  57 // get table; version tells how many
  58 OBJC_EXPORT void objc_exception_get_functions(objc_exception_functions_t *table);
  59
  60 // set table
  61 OBJC_EXPORT void objc_exception_set_functions(objc_exception_functions_t *table);
  62
  63 #endif  // __OBJC_EXCEPTION_H_
  64