#pragma声明主要由Xcode用来完成两个主要任务——整理代码和防止编译器警告。
整理代码
代码的整洁程度反映了程序员及其代码的靠谱程度。缺少惯性和一致性的代码表明作者要么疏忽要么无能,更遭到的是,使得一个项目难以维护和协作。
好的习惯从#prama mark开始。就像这样:
@implementation ViewController
- (id)init {
...
}
#pragma mark - UIViewController
- (void)viewDidLoad {
...
}
#pragma mark - IBAction
- (IBAction)cancel:(id)sender {
...
}
#pragma mark - UITableViewDataSource
- (NSInteger)tableView:(UITableView *)tableView numberOfRowsInSection:(NSInteger)section {
...
}
#pragma mark - UITableViewDelegate
- (void)tableView:(UITableView *)tableView didSelectRowAtIndexPath:(NSIndexPath *)indexPath {
...
}
在你的@implementation中使用#pragma mark ,将代码分割成多个逻辑块。这些逻辑区块不仅使得阅读代码本身容易许多,也为Xcode源导航增加了视觉线索。
一个好的习惯是将一个类里面的所有方法根据它们的来源组合放在一起。比如,来源UITableViewDelegate的所有方法放在一起并在这些方法前加入#pragma mark - UITableViewDelegate
标注。
防止警告
#pragma mark同样可以用来防止来自编译器或者静态分析器的警告,这点用的比较少。
比糟糕格式的代码更烦人的是生成警告的代码。尤其是第三方类库的代码。可是,绝大多数时候没有办法避免编译器警告。在某些罕见的场景中,你绝对肯定一个编译器异常或者静态分析器异常需要被抑制,那么#prama就派上了用场:
// completionBlock在AFURLConnectionOperation中被手动的设置为nil来打破保留周期。
#pragma clang diagnostic push
#pragma clang diagnostic ignored "-Warc-retain-cycles"
self.completionBlock = ^ {
...
};
#pragma clang diagnostic pop
幸运的是,Clang提供了一个便捷的方法解决了这一切。通过使用#prama clang diagnostic push/pop, 你可以告诉编译器针对某一特定部分代码来忽视特定的警告。
你可以在Clang Compiler User's Manual读到更多关于#pragma的LLVM用法的知识。
只是不要用这种方法来清扫合法的警告,这会在后续工作中带来很大的麻烦。