继承自 | 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:方法,然后将你的实例用这个键安装到当前的线程属性字典。