Pragma

Pragma Mark

#pragma mark - 是一个在类内部组织代码并且帮助你分组方法实现的好办法。 我们建议使用 #pragma mark - 来分离:

  • 不同功能组的方法
  • protocols 的实现
  • 对父类方法的重写
  1. - (void)dealloc { /* ... */ }
  2. - (instancetype)init { /* ... */ }
  3. #pragma mark - View Lifecycle View 的生命周期)
  4. - (void)viewDidLoad { /* ... */ }
  5. - (void)viewWillAppear:(BOOL)animated { /* ... */ }
  6. - (void)didReceiveMemoryWarning { /* ... */ }
  7. #pragma mark - Custom Accessors (自定义访问器)
  8. - (void)setCustomProperty:(id)value { /* ... */ }
  9. - (id)customProperty { /* ... */ }
  10. #pragma mark - IBActions
  11. - (IBAction)submitData:(id)sender { /* ... */ }
  12. #pragma mark - Public
  13. - (void)publicMethod { /* ... */ }
  14. #pragma mark - Private
  15. - (void)zoc_privateMethod { /* ... */ }
  16. #pragma mark - UITableViewDataSource
  17. - (UITableViewCell *)tableView:(UITableView *)tableView cellForRowAtIndexPath:(NSIndexPath *)indexPath { /* ... */ }
  18. #pragma mark - ZOCSuperclass
  19. // ... 重载来自 ZOCSuperclass 的方法
  20. #pragma mark - NSObject
  21. - (NSString *)description { /* ... */ }

上面的标记能明显分离和组织代码。你还可以用 cmd+Click 来快速跳转到符号定义地方。
但是小心,即使 paragma mark 是一门手艺,但是它不是让你类里面方法数量增加的一个理由:类里面有太多方法说明类做了太多事情,需要考虑重构了。

关于 pragma

http://raptureinvenice.com/pragmas-arent-just-for-marks 有很好的关于 pragma 的讨论了,在这边我们再做部分说明。

大多数 iOS 开发者平时并没有和很多编译器选项打交道。一些选项是对控制严格检查(或者不检查)你的代码或者错误的。有时候,你想要用 pragma 直接产生一个异常,临时打断编译器的行为。

当你使用ARC的时候,编译器帮你插入了内存管理相关的调用。但是这样可能产生一些烦人的事情。比如你使用 NSSelectorFromString 来动态地产生一个 selector 调用的时候,ARC不知道这个方法是哪个并且不知道应该用那种内存管理方法,你会被提示 performSelector may cause a leak because its selector is unknown(执行 selector 可能导致泄漏,因为这个 selector 是未知的).

如果你知道你的代码不会导致内存泄露,你可以通过加入这些代码忽略这些警告

  1. #pragma clang diagnostic push
  2. #pragma clang diagnostic ignored "-Warc-performSelector-leaks"
  3. [myObj performSelector:mySelector withObject:name];
  4. #pragma clang diagnostic pop

注意我们是如何在相关代码上下文中用 pragma 停用 -Warc-performSelector-leaks 检查的。这确保我们没有全局禁用。如果全局禁用,可能会导致错误。

全部的选项可以在 The Clang User’s Manual 找到并且学习。

忽略没用使用变量的编译警告

告诉你申明的变量它将不会被使用,这种做法很有用。大多数情况下,你希望移除这些引用来(稍微地)提高性能,但是有时候你希望保留它们。为什么?或许它们以后有用,或者有些特性只是暂时移除。无论如何,一个消除这些警告的好方法是用相关语句进行注解,使用 #pragma unused():

  1. - (NSInteger)giveMeFive
  2. {
  3. NSString *foo;
  4. #pragma unused (foo)
  5. return 5;
  6. }

现在你的代码不用任何编译警告了。注意你的 pragma 需要标记到问题代码之下。