Created
February 25, 2013 17:13
-
-
Save mattt/5031388 to your computer and use it in GitHub Desktop.
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
/** NSAssertionHandler - Object encapsulation of assertions | |
Copyright (C) 1995, 1997 Free Software Foundation, Inc. | |
Written by: Adam Fedor <fedor@boulder.colorado.edu> | |
Date: Apr 1995 | |
This file is part of the GNUstep Base Library. | |
This library is free software; you can redistribute it and/or | |
modify it under the terms of the GNU Lesser General Public | |
License as published by the Free Software Foundation; either | |
version 2 of the License, or (at your option) any later version. | |
This library is distributed in the hope that it will be useful, | |
but WITHOUT ANY WARRANTY; without even the implied warranty of | |
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU | |
Library General Public License for more details. | |
You should have received a copy of the GNU Lesser General Public | |
License along with this library; if not, write to the Free | |
Software Foundation, Inc., 51 Franklin Street, Fifth Floor, | |
Boston, MA 02111 USA. | |
<title>NSAssertionHandler class reference</title> | |
$Date$ $Revision$ | |
*/ | |
#import "common.h" | |
#import "GNUstepBase/GSConfig.h" | |
#import "Foundation/NSException.h" | |
#import "Foundation/NSDictionary.h" | |
#import "Foundation/NSThread.h" | |
/** | |
* <p>NSAssertionHandler objects are used to raise exceptions on behalf of | |
* macros implementing assertions.<br /> | |
* Each thread has its own assertion handler instance.<br /> | |
* </p> | |
* <p>The macros work together with the assertion handler object to | |
* produce meaningful exception messages containing the name of the | |
* source file, the position within that file, and the name of the | |
* ObjC method or C function in which the assertion failed. | |
* </p> | |
* <p>An NSAssertionHandler instance is created on demand for each thread | |
* and is stored in the thread's dictionary under the key NSAssertionHandler. | |
* A custom NSAssertionHandler can be used by adding it to the thread | |
* dictionary under this key. | |
* </p> | |
* The assertion macros are: | |
* NSAssert(), NSCAssert(), | |
* NSAssert1(), NSCAssert1(), | |
* NSAssert2(), NSCAssert2(), | |
* NSAssert3(), NSCAssert3(), | |
* NSAssert4(), NSCAssert4(), | |
* NSAssert5(), NSCAssert5(), | |
* NSParameterAssert(), NSCParameterAssert() | |
*/ | |
@implementation NSAssertionHandler | |
/* Key for thread dictionary. */ | |
NSString *const NSAssertionHandlerKey = @"NSAssertionHandler"; | |
/** | |
* Returns the assertion handler object for the current thread.<br /> | |
* If none exists, creates one and returns it. | |
*/ | |
+ (NSAssertionHandler*) currentHandler | |
{ | |
NSMutableDictionary *dict; | |
NSAssertionHandler *handler; | |
dict = GSCurrentThreadDictionary(); | |
handler = [dict objectForKey: NSAssertionHandlerKey]; | |
if (handler == nil) | |
{ | |
handler = [[NSAssertionHandler alloc] init]; | |
[dict setObject: handler forKey: NSAssertionHandlerKey]; | |
RELEASE(handler); | |
} | |
return handler; | |
} | |
/** | |
* Handles an assertion failure by using NSLogv() to print an error | |
* message built from the supplied arguments, and then raising an | |
* NSInternalInconsistencyException | |
*/ | |
- (void) handleFailureInFunction: (NSString*)functionName | |
file: (NSString*)fileName | |
lineNumber: (NSInteger)line | |
description: (NSString*)format,... | |
{ | |
id message; | |
va_list ap; | |
va_start(ap, format); | |
message = | |
[NSString | |
stringWithFormat: @"%@:%d Assertion failed in %@. %@", | |
fileName, line, functionName, format]; | |
NSLogv(message, ap); | |
[NSException raise: NSInternalInconsistencyException | |
format: message arguments: ap]; | |
va_end(ap); | |
GS_UNREACHABLE(); | |
/* NOT REACHED */ | |
} | |
/** | |
* Handles an assertion failure by using NSLogv() to print an error | |
* message built from the supplied arguments, and then raising an | |
* NSInternalInconsistencyException | |
*/ | |
- (void) handleFailureInMethod: (SEL) aSelector | |
object: object | |
file: (NSString *) fileName | |
lineNumber: (NSInteger) line | |
description: (NSString *) format,... | |
{ | |
id message; | |
va_list ap; | |
va_start(ap, format); | |
message = | |
[NSString | |
stringWithFormat: @"%@:%d Assertion failed in %@(%@), method %@. %@", | |
fileName, line, NSStringFromClass([object class]), | |
class_isMetaClass([object class]) ? @"class" : @"instance", | |
NSStringFromSelector(aSelector), format]; | |
NSLogv(message, ap); | |
[NSException raise: NSInternalInconsistencyException | |
format: message arguments: ap]; | |
va_end(ap); | |
/* NOT REACHED */ | |
GS_UNREACHABLE(); | |
} | |
@end |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment