//

 //  ExceptionUtils.h

 //  MYUtilities

 //

 //  Created by Jens Alfke on 1/5/08.

 //  Copyright 2008 Jens Alfke. All rights reserved.

 //  See BSD license at bottom of ExceptionUtils.m.

 //

 #import <Foundation/Foundation.h>

 #ifdef NSAppKitVersionNumber10_4 // only enable this in a project that uses AppKit

 /** Edit your Info.plist to make this your app's principal class,

     and most exceptions will be reported via a modal alert. 

     This includes exceptions caught by AppKit (i.e. uncaught ones from event handlers)

     and ones you report yourself via MYReportException and @catchAndReport. */

 @interface MYExceptionReportingApplication : NSApplication

 @end

 #endif

 /** A useful macro to use in code where you absolutely cannot allow an exception to 

     go uncaught because it would crash (e.g. in a C callback or at the top level of a thread.)

     It catches the exception but makes sure it gets reported. */

 #define catchAndReport(MSG...) @catch(NSException *x) {MYReportException(x,MSG);}

 /** Report an exception that's being caught and consumed.

     Logs a warning to the console, and calls the current MYReportException target if any. */

 void MYReportException( NSException *x, NSString *where, ... );

 /** Sets a callback to be invoked when MYReportException is called.

     In a GUI app, the callback would typically call [NSApp reportException: theException].

     The ExceptionReportingApplication class, below, sets this up automatically. */

 void MYSetExceptionReporter( void (*reporter)(NSException*) );

 @interface NSException (MYUtilities)

 /** Returns a textual, human-readable backtrace of the point where the exception was thrown. */

 - (NSString*) my_callStack;

 @end

 BOOL IsGDBAttached( void );