《编写高质量iOS与OS X代码的52个有效方法》--第六章 第38条
(ps:此乃读书笔记,加深记忆,仅供大家参考)
第38条:为常用的块类型创建typedef
每个块都具备其“固有类型”(inherent type),因而可将其赋值给适当类型的变量。这个类型由块所接受的参数及其返回值组成。
如果想把块赋给变量,则需注意其类型。变量类型及相关赋值语句如下:
int someInt = 0;
int (^variableName)(BOOL flag, int value) = ^(BOOL flag, int value)
{
return someInt;
};
这个类型似乎和普通的类型大不相同,然而如果习惯函数指针的话,那么看上去就会觉得眼熟了。块类型的语法结构如下:
return_type (^block_name)(parameters)
与其他类型的变量不同,在定义块变量时,要把变量名放在类型之中,而不要放在右侧。这种语法非常难记,也非常难读。鉴于此,我们应该为常用的块类型起个别名,尤其是打算把代码发布成API供他人使用时,更应该这样做。开发者可以起个更为易读的名字来表示块的用途,而把块的类型隐藏在其后面。
为了隐藏复杂的块类型,需要用到C语言中名为“类型定义”(type definition)的特性。typedef关键字用于给类型起个易读的别名:
typedef int (^EOCSomeBlock)(BOOL flag, int value);
声明变量时,要把名称放在类型中间,并在前面加上“^”符号,而定义新类型时也得这么做。此后,不用再以复杂的块类型来创建变量了,直接使用新类型即可:
EOCSomeBlock block = ^(BOOL flag, int value)
{
return someInt;
};
与定义其他变量时一样,变量类型在左边,变量名在右边。类里面有些方法可能需要用块来做参数,比如执行异步任务时所用的“completion handler”(任务完成后所执行的处理程序)参数就是块,凡遇到这种情况,都可以通过定义别名使代码变得更为易读。
注意,定义方法参数所用的块类型语法,又和定义变量时不同。若能把方法签名中的参数类型写成一个词,那读起来就顺口多了。于是可以给参数类型起个别名,然后使用此名称来定义:
typedef void (^EOCCompletionHandler)(NSData *data, NSError *error);
- (void)startWithCompletionHandler:(EOCCompletionHandler)completion;
当前,优秀的集成开发环境(Integrated Development Environment, IDE)都可以自动把类型定义展开,所以typedef这个功能变得很实用。
使用类型定义还有个好处,就是当你打算重构块的类型签名时会很方便。比方说,要给原来的completion handler块再加一个参数,用以表示完成任务所花的时间,那么只需修改类型定义语句即可:
typedef void (^EOCCompletionHandler)(NSData *data, NSTimeInterval duration, NSError *error);
修改之后,凡是使用了这个类型定义的地方,比如方法签名处,都会无法编译,而且报的是同一种错误,于是开发者可据此逐个修复。
最好在使用块类型的类中定义这些typedef,而且还应该把这个类的名字加在由typedef所定义的新类型名前面,这样可以阐明块的用途。还可以用typedef给同一个块签名类型创建数个别名。
Mac OS X与iOS的Accounts框架就是个例子。在该框架中可以找打下面这两个类型定义语句:
typedef void(^ACAccountStoreSaveCompletionHandler)(BOOL success, NSError *error);
typedef void(^ACAccountStoreRemoveCompletionHandler)(BOOL success, NSError *error);
typedef void(^ACAccountStoreRequestAccessCompletionHandler)(BOOL granted, NSError *error);
类型定义的签名相同,但用在不同的地方。开发者看到类型别名及签名中的参数之后,很容易就能理解此类型的用途。
与此相似,如果有好几个类都要执行相似但各有区别的异步任务,而这几个类又不能放入同一个继承体系,那么,每个类就应该有自己的completion handler类型。这几个completion handler的签名也许完全相同,但最好还是在每个类里都各自定义一个别名,而不要共用同一个名称。反之,若这些类能纳入同一个继承中,则应该将类型定义的语句放在超类中,以供各子类使用。
要点
- 以typedef重新定义块类型,可令块变量用起来更加简单。
- 定义新类型时应遵从现有的命名习惯,勿使其名称与别的类型相冲突。
- 不妨为同一块签名定义多个类型别名。如果要重构代码使用了块类型的某个别名,那么只需修改相应typedef中的块签名即可,无须改动其他typedef。