简介
NSAssertionHandler,断言。
NSAssertionHandler实例是自动创建的,用于处理错误断言。断言宏,比如NSAssert和NSCAssert,用于评估一个条件,如果条件评估为错误,这个宏向NSAssertionHandler实例发送一个表示错误的字符串。每个线程都有它自己的NSAssertionHandler实例。断言处理程序调用的时候,会打印一条错误信息,包含断言的方法或类,并抛出一个NSInternalInconsistencyException。
注意:一般情况下我们精良不要使用这个类,他可能导致不能预测的错误,尤其是在你的线上的版本中
方法
+ currentHandler//返回当前线程的断言处理实例。
如果当前线程没有相关联的断言处理实例,这个方法会创建一个并将它分配给这个线程。
- handleFailureInFunction:file:lineNumber:description:
记录错误信息日志(使用NSLog),包含函数名,文件名和行号。
- (void)handleFailureInFunction:(NSString *)functionName file:(NSString *)fileName lineNumber:(NSInteger)line description:(NSString *)format,...
参数
functionName:失败的函数
fileName:失败的源文件
line:失败的行数
format,...:格式化字符串
抛出NSInternalInconsistencyException。
- (void)handleFailureInMethod:(SEL)selector object:(id)object file:(NSString *)fileName lineNumber:(NSInter)line description:(NSString *)format,...
参数
selector:失败的方法的选择器
object:失败的对象
fileName:失败的源文件
line:失败的行数
format,...:格式化字符串
如果你需要自定义NSAssertionHandler的行为,创建子类,重写handleFailureInMethod:object:file:lineNumber:description:和handleFailureInFunction:file:lineNumber:description:方法,然后将你的实例用这个键安装到当前的线程属性字典。
@interface LoggingAssertionHandler : NSAssertionHandler
@end
@implementation LoggingAssertionHandler
- (void)handleFailureInMethod:(SEL)selector
object:(id)object
file:(NSString *)fileName
lineNumber:(NSInteger)line
description:(NSString *)format, ...
{
NSLog(@"NSAssert Failure: Method %@ for object %@ in %@#%i", NSStringFromSelector(selector), object, fileName, line);
}
- (void)handleFailureInFunction:(NSString *)functionName
file:(NSString *)fileName
lineNumber:(NSInteger)line
description:(NSString *)format, ...
{
NSLog(@"NSCAssert Failure: Function (%@) in %@#%i", functionName, fileName, line);
}
@end
- (BOOL)application:(UIApplication *)application
didFinishLaunchingWithOptions:(NSDictionary *)launchOptions
{
NSAssertionHandler *assertionHandler = [[LoggingAssertionHandler alloc] init];
[[[NSThread currentThread] threadDictionary] setValue:assertionHandler
forKey:NSAssertionHandlerKey];
// ...
return YES;
}