NSAssertionHandler类

继承自NSObject符合NSObject(NSObject)框架 /System/Library/Frameworks/Foundation.framework可用性可用于iOS 2.0或者更晚的版本声明于Foundation/NSException.h参考指南Assertions and Logging

概览

NSAssertionHandler实例是自动创建的，用于处理错误断言。断言宏，比如NSAssert和NSCAssert，用于评估一个条件，如果条件评估为错误，这个宏向NSAssertionHandler实例发送一个表示错误的字符串。每个线程都有它自己的NSAssertionHandler实例。断言处理程序调用的时候，会打印一条错误信息，包含断言的方法或类，并抛出一个NSInternalInconsistencyException。

你仅仅通过使用断言宏创建断言—很少需要直接调用NSAssertionHandler方法。宏内使用的方法发送handleFailureInMethod:object:file:lineNumber:description:和handleFailureInFunction:file:lineNumber:description:消息到当前断言处理程序。当前线程的断言处理程序使用currentHandler方法获得。如果你需要自定义NSAssertionHandler的行为，参开NSAssertionHandlerKey。

方法

+ currentHandler

返回当前线程的断言处理实例。

+ (NSAssertionHandler *)currentHandler

参数 返回值当前线程的断言处理实例

论述

如果当前线程没有相关联的断言处理实例，这个方法会创建一个并将它分配给这个线程。

- handleFailureInFunction:file:lineNumber:description:

记录错误信息日志（使用NSLog），包含函数名，文件名和行号。

- (void)handleFailureInFunction:(NSString *)functionName file:(NSString *)fileName lineNumber:(NSInteger)line description:(NSString *)format,...

参数functionName:失败的函数
fileName:失败的源文件
line:失败的行数
format,...:格式化字符串返回值 

论述

抛出NSInternalInconsistencyException。

- handleFailureInMethod:object:file:lineNumber:description:

- (void)handleFailureInMethod:(SEL)selector object:(id)object file:(NSString *)fileName lineNumber:(NSInter)line description:(NSString *)format,...

参数selector:失败的方法的选择器
object:失败的对象
fileName:失败的源文件
line:失败的行数
format,...:格式化字符串返回值 

论述

抛出NSInternalInconsistencyException。

常量

异常内容的字符串在Foundation Constants Reference部分列出并描述。

NSAssertionHandlerKey

一个常量，指向每个线程的断言处理实例字典中的键。

NSString * const NSAssertionHandlerKey

一个在线程字典中拥有相应值的键。

如果你需要自定义NSAssertionHandler的行为，创建子类，重写handleFailureInMethod:object:file:lineNumber:description:和handleFailureInFunction:file:lineNumber:description:方法，然后将你的实例用这个键安装到当前的线程属性字典。