Objective-C 编程：NSAssert

#define NSAssert(condition, desc, ...)

如果给定条件为假，则生成一个断言。

参数：

• condition：表达式，计算结果为 YES 或者 NO。
• desc：NSString 对象类型的字符串，其中包含一个 printf-style 样式的字符串，该字符串中包含一条描述失败条件和占位符参数的错误消息。

断言（Assertion）是指在开发期间使用的、让程序在运行时进行自检的代码（通常是一个子程序或宏）。断言为真，则表明程序运行正常，而断言为假，则意味着它已经在代码中发现了意料之外的错误。断言对于大型的复杂程序或可靠性要求极高的程序来说尤其有用。

Assert 用于在代码中强制执行语义约定（编写“防御性代码”），示例代码：

- (void)doSomethingWithString:(NSString *)string {
    NSAssert(string != nil, @"parameters should not be nil");
    
    // ... 执行正常流程
}

因此，它不仅可以安全防范潜在的不良输入，而且还可以以一种有用的标准方式记录它们。

断言是为了确保一个值是它所应该的值。如果断言失败了，就意味着哪里出了问题，因此程序会崩溃退出。使用 Assert 的一个原因是，如果你有一个函数，如果传递给它的参数不是某个值（或一个值的范围），你可以使用 Assert 来确保这个值是你所期望的值，如果不是，那就意味着真的出了问题，所以应用程序会崩溃退出。Assert 对于调试/单元测试非常有用，当你对外提供框架来阻止用户做 "邪恶 "的事情时，Assert 也是非常有用的。

NSAssert 宏对断言条件进行评估，并作为断言处理程序的前端。

每个线程都有自己的断言处理程序，它是 NSAssertionHandler 对象类型。当被调用时，断言处理程序会打印一条错误消息，其中包括方法和类名（或函数名）。然后它会引发一个 NSInternalInconsistencyException 异常。如果条件值为 NO，NSAssert() 宏会在当前线程的断言处理程序上调用 handleFailureInMethod:object:file:lineNumber:description: 方法，并传递 desc 参数作为描述字符串。

NSAssert() 宏只能在 Objective-C 语言的方法中使用。

如果定义了预处理程序宏 NS_BLOCK_ASSERTIONS 或者 Xcode 编译设置（build setting）中的 ENABLE_NS_ASSERTIONS 项被禁用了，那么断言将被禁用。

重要

不要在这个宏的条件参数中调用带有副作用的函数（避免把「需要执行有效操作的代码」放到断言中）。当断言被禁用时，条件参数不会被评估，所以如果你调用了带有副作用的函数，当你在非调试配置中构建项目时，这些函数可能永远不会被调用。

从 Xcode 4.2 开始，release 版默认关闭了断言。也就是当编译发布版时，任何调用 NSAssert() 的地方都被空行替换。所以，不要在 NSAssert() 内执行任何有效操作。

Note

并非所有版本的配置都会默认禁用断言。

如果想要在发布版中使用 NSAssert()，可以在 Build Setting 中的 Enable Foundation Assertions 中修改（不建议！！！）。

参考

• Apple: NSAssert
• stackoverflow：What is NSAssert1?
• stackoverflow：What's the point of NSAssert, actually?
• 简书：断言 NSAssert 的使用
• CSDN：iOS 开发中断言的使用 —NSAssert ()