mirror of
https://github.com/gnustep/libs-base.git
synced 2025-04-30 20:10:53 +00:00
Richard: I'm unsure about three of these, which were fixes in memset() calls in: - NSConcreteMapTable.m - NSConcreteHashTable.m - Additions/NSData+GNUstepBase.m Please can you check them? I think they are intended to zero the entire object (rather than the first word), but the lack of comments makes me unsure. Most changes were just tweaks to variable types. I've also removed some dead code from NSInvocation. This was small group of things that were marked for internal use only, but not actually referenced in the code anywhere. Other improvements: - NSArray / NSDictionary fixed up to use the 10.7 (ARC-friendly) prototypes. - getObjects:andKeys: implemented for NSDictionary (10.5 method) - NSPointerArray and NSHashTable now properly support weak objects. - Tests for weak objects in collections. git-svn-id: svn+ssh://svn.gna.org/svn/gnustep/libs/base/trunk@33621 72102866-910b-0410-8b05-ffd578937521
141 lines
4.4 KiB
Objective-C
141 lines
4.4 KiB
Objective-C
/** 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/preface.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
|