Block的用法

块(block)是添加到C、Objective-C和C++的语言级功能。它允许你创建不同的代码段,可以像传值一样传递给方法或函数。块是Objective-C对象,也就是说它们可以被添加到像NSArrayNSDictionary这样的集合中,其还具有从封闭范围捕获值的能力。

块是一个独立的代码片段,始终存在于另一个编程结构的范围内,如在一个方法的主体。块可以捕获块外变量的值,但外部对于块内发生的事情一无所知。在块内不能直接修改局部变量的值,如需修改需用__block修饰局部变量。

1. 创建demo

这篇文章演示的应用程序由多个彼此独立的部分组成,代码运行结果可以在控制台输出,但为了介绍使用block传值,这里使用Single View Application模板,Product NameBlock

在这篇文章里,没有特殊说明位置的代码都可以写在ViewController.m文件的viewDidLoad方法中。运行可以在控制台输出。

2. Block的声明、定义、赋值与调用

Block.jpeg

2.1 Block的声明

Block声明遵循以下语法:

返回值类型 (^block名称)(参数列表)

Block声明的语法和C函数非常相似,不同之处在于block有脱字符^

  • 返回值类型:任何Objective-C支持的数据类型。如果不返回任何内容,则为void
  • ^block名称:block名称前的脱字符^不可省略。块名称和其它变量或方法名命名规则一致。脱字符和块名称都在圆括号内。
  • 参数列表:要在块上传递的参数列表,与方法的参数一样。如果不传递参数,设置为void。有多个参数时,参数间用逗号隔开。参数列表必需在圆括号内。

下面是一些block的声明:

    int (^firstBlock)(NSString *param1, int param2);    // 返回类型为int 参数1为NSString类型 参数2为int类型
    void (^showName)(NSString *pro648);                 // 无返回内容 参数为NSString类型
    void (^allVoid)(void);                              // 无返回内容 不传递参数
    NSDate *(^whatDayIsIt)(void);                       // 返回类型为NSDate 不传递参数
    NSString *(^composeName)(NSString *, NSString *);   // 返回类型为NSString 两个参数均为NSString类型 参数名称可以省略

可以看到,最后一个块的参数名称被省略掉了。事实上,为块的参数添加名称仅有助于开发人员记住其用途,编译器会忽略参数名称。所以,上面所有块声明中的参数名称都可以省略。

如果块的参数为空,声明时应将其声明为void类型。如果将其声明为如下类型:

    void (^pro)();

则表示参数未指定,而非没有参数。另外,在Xcode 9中这样声明block会收到This block declaration is not a prototype的警告。

这样声明的块可以通过以下方式调用:

    void(^pro)() = ...
    
    pro();
    pro(3);
    pro(@"648");

这样会很容易产生bug。因此声明没有参数的块时,我们应该这样声明:

    void(^pro)(void);

Apple在自身的API中,并没有完全遵照这样的规则,也可能是基于兼容性考虑,其并没有更新旧有的API。在使用新API前,Xcode中的警告会一直存在。但你可以通过Build Settings关闭该提醒:

BlockWarn.png

2.2 Block变量的定义

Block的定义遵循以下语法:

^返回值类型(参数列表){
... 块主体 ...
return 返回值  // 如果返回值类型是void,则没有return
};

块的定义中没有块的名称。

  • 脱字符^:不可省略。
  • 返回值类型:一般省略。返回类型与块声明时返回类型相同。
  • 参数列表:与块的声明不同的是这里参数名称不可省略。如果参数列表有多个参数,则声明和定义的参数顺序应相同。
  • 块主体:大括号{}标志块的开始和结束。如果有返回值,结束时会return返回值。因为整个block被视为一个变量,结束处大括号后的分号;不可省略。不用担心忘记,编译器会提醒你的。

下面是一个简单示例:

    ^(double firstValue, double secondValue){
        return firstValue * secondValue;
    };

一般,block的定义会被赋值给变量,或者在方法调用时将块的定义作为完成处理程序。

2.3 Block的赋值与调用

下面是完整的块声明、赋值、调用。

    // 1 声明一个块变量
    double (^multiplyTwoValues)(double, double);
    // 2 赋值
    multiplyTwoValues = ^(double firstValue, double secondValue){
        return firstValue * secondValue;
    };
    // 3 调用块
    NSLog(@"multiplyTwoValues %f",multiplyTwoValues(1.1, 2));

以下是上述代码的分步说明:

  1. 声明一个返回值类型为double,两个参数均为double的块变量。
  2. 刚定义的块赋值给1中声明的块变量multiplyTwoValues
  3. NSLog中调用块,块的两个参数分别为1.12。如果调用一个只声明、没有赋值的块,app会崩溃。

也可以把上面代码中的声明和赋值合并在一起。

    double (^multiplyTwoValues)(double, double) = ^(double firstValue, double secondValue){
        return firstValue * secondValue;
    };

运行app,控制台输出如下:

multiplyTwoValues 2.200000

3. Block内捕获局部变量

除了包含可执行代码,块还具有捕获块以外的值的能力。如果在一个方法内声明了一个块,该块可以获取方法内任何变量,也就是可以获取局部变量。

3.1 Block可以捕获局部变量的值

ViewController.m添加一个testBlockStorageType的方法,在该方法内添加一个块,在块内尝试获取方法内变量的值。最后记得在viewDidLoad方法中调用该方法。

- (void)viewDidLoad {
    ...
    [self testBlockStorageType];
}

- (void)testBlockStorageType{
    int anInteger = 648;
    
    // 用块获取局部变量的值 
    void (^myOperation)(void) = ^(void){
        NSLog(@"Integer is %i",anInteger);
    };
    myOperation();
}

在这个示例,在block外声明anInteger,块在定义时捕获anInteger变量的值。

控制台输出为:

Integer is 648

3.2 Block不能修改局部变量的值

Block可以捕获局部变量的值,默认获取到的值是只读的,也就是说block不能改变局部变量的值。如果在块内尝试改变局部变量的值,会出现错误提示。

- (void)testBlockStorageType{
    int anInteger = 648;
    
    // 用块获取局部变量的值
    void (^myOperation)(void) = ^(void){
        anInteger = 20;
        NSLog(@"Integer is %i",anInteger);
    };
    
    myOperation();
}

错误提示:

Variable is not assignable(missing __block type specifier)

3.3 Block在定义时具有了值

如果在块定义后、调用前改变局部变量的值,如下:

    int anInteger = 648;
    
    // 用块获取局部变量的值
    void (^myOperation)(void) = ^(void){
        NSLog(@"Integer is %i",anInteger);
    };
    
    anInteger = 64;
    myOperation();

运行demo,控制台输出如下:

Integer is 648

anInteger的值是648,而不是64,这是因为变量anInteger在定义块时已经具有了值,而不是在块执行的时候。

3.4 用__block修饰局部变量

如果需要在块内修改局部变量的值,可以使用__blcok修饰局部变量的值。修饰后的局部变量保存于块和局部变量的共享存储中。

重写上面代码如下:

    __block int anInteger = 648;
    
    // 用块获取局部变量的值
    void (^myOperation)(void) = ^(void){
        NSLog(@"Integer is %i",anInteger);
    };
    
    anInteger = 64;
    myOperation();

因为anInteger被声明为__block变量,所以它的存储与块声明共享。

运行demo,控制台输出如下:

Integer is 64

Block也可以改变__block修饰的局部变量的值。如下:

    __block int anInteger = 648;
    
    // 用块获取局部变量的值
    void (^myOperation)(void) = ^(void){
        NSLog(@"Integer is %i",anInteger);
        anInteger = 100;
    };
    
    myOperation();
    NSLog(@"Value of original varialbe is now: %i",anInteger);

输出为:

Integer is 648
Value of original varialbe is now: 100

4. Block内捕获全局变量

4.1 在block中可以捕获全局变量的值

打开ViewController.h,在interface前声明全局变量如下:

#import <UIKit/UIKit.h>

int gGlobalVar = 5;

@interface ViewController : UIViewController

继续在testBlockStorageType方法中添加代码,捕获全局变量的值。

- (void)testBlockStorageType{
    ...
    void (^globalTest)(void) = ^(void){
        NSLog(@"gGlobalVar is: %i",gGlobalVar);
    };
    globalTest();
}

输出为:

gGlobalVar is: 5

4.2 在block中可以直接修改全局变量的值

在块内修改全局变量的值不需要在全局变量前添加修饰,可以直接修改。

- (void)testBlockStorageType{
    ...
    void (^globalTest)(void) = ^(void){
        NSLog(@"gGlobalVar is: %i",gGlobalVar);
        gGlobalVar = 3;
    };
    globalTest();
    NSLog(@"Value of original gGlobalVar is: %i",gGlobalVar);
}

输出为:

gGlobalVar is: 5
Value of original gGlobalVar is: 3

4.3 在定义block后、调用前改变全局变量的值,在调用block时,全局变量值是修改后的值。

- (void)testBlockStorageType{
    ...
    void (^globalTest)(void) = ^(void){
        NSLog(@"gGlobalVar is: %i",gGlobalVar);
        gGlobalVar = 3;
    };
    gGlobalVar = 7;
    globalTest();
    NSLog(@"Value of original gGlobalVar is: %i",gGlobalVar);
}

输出为:

gGlobalVar is: 7
Value of original gGlobalVar is: 3

5. Block捕获静态变量

ViewController.m接口和实现部分中间声明静态变量。

@end

static int age = 20;

@implementation ViewController

用块获取静态变量的值、修改静态变量的值等与处理全局变量的值方法一致,这里不再叙述步骤,你可以自行尝试。

尝试后你会发现如下规律:

  1. 块可以获取静态变量的值。
  2. 块可以修改静态变量的值。
  3. 在块定义后、调用前修改静态变量的值,调用时静态变量的值是修改后的值。

总结,块可以获取块外部的值。

__block修饰的局部变量才可以修改,全局变量、静态变量不需修饰可以直接修改。

在块定义后、调用前修改变量的值,调用时全局变量和静态变量统一为修改后的值;对于局部变量则是:如果局部变前有__block修饰,则为修改后的值,否则为修改前的值。

6. 将块作为方法或函数的参数传递

在前面的示例中,block均是定义后立即调用。在实际应用中,通常将块传递给其它地方的函数或方法。例如:可以使用Grand Central Dispatch在后台调用块,或者定义一个块来表示要重复调用的任务,如枚举集合。

框架方法中经常使用块的两个典型示例是:

  • 当显示模态视图控制器时,如果要在视图控制器显示之后处理某些内容。
    [self presentViewController:viewController animated:YES completion:^{
        NSLog(@"View Controller was presented");
        
        // Other code related to view controller presentation.
    }];
  • 执行UIView动画。
    [UIView animateWithDuration:0.5
                     animations:^{
                         // Animation related code here...
                         [self.view setAlpha:0.8];
                     }
                     completion:^(BOOL finished) {
                         // Any completion handler related code here...
                         NSLog(@"Animation is over.");
                     }];

下面将创建一个简单的方法,用以学习完成处理程序。为了使代码简单,我们将实现一个添加两个整数的方法,通过完成处理程序返回结果,而不是将结果返回给调用者。

在键盘上按下command+N,添加一个模板为Cocoa Touch Class,父类为NSObject,类名为Handler的文件。

Handler.h文件添加以下方法:

- (void)addNumber:(int)number1 withNumber:(int)number2 andCompletionHandler:(void(^)(int result))completionHandler;

上述代码声明的方法有三个参数,前两个是我们想要相加的数字,最后一个是完成处理程序。完成处理程序的名称可以根据需要自行设定。这里完成处理程序的块包括一个参数,该参数用以返回给方法调用者结果。

Handler.m实现部分添加如下代码:

- (void)addNumber:(int)number1 withNumber:(int)number2 andCompletionHandler:(void (^)(int))completionHandler{
    int result = number1 + number2;
    completionHandler(result);
}

在上述代码中,将两个数字相加,调用完成处理程序,完成处理程序的参数即数字相加的结果。

进入ViewController.m,导入Handler.m,在viewDidLoad方法中调用上面方法。

- (void)viewDidLoad {
    ...
    Handler *handler = [[Handler alloc] init];
    [handler addNumber:3 withNumber:5 andCompletionHandler:^(int result) {
        NSLog(@"handler %i",result);
    }];
}

当调用方法时,传递35作为参数,并定义完成处理程序,这里直接输出结果。

handler 8

最好的做法是只对方法使用一个块参数。如果该方法还需要其它非块参数,则该块应该是最后一个参数。

很明显,也可以使用委托(delegation)来实现上述功能,如果使用委托,需要创建一项协议,实现协议方法,将对象设置为任务的委托,在需要传值的位置调用协议方法。然而,块比委托更容易实现,代码更简洁。

如果你对委托(delegation)的使用有疑惑,可以查看我的另一篇文章如何使用委托

7. 避免循环引用

如果在块中用到self,需要考虑其对内存管理的影响。

块对捕获的任何对象都是强引用(包括self ),如果对象内部有一个block属性,而在block内部又访问了该对象(self),会造成循环引用。

@interface ViewController ()

@property (copy) void (^myBlock)(void);

@end

- (void)configureMyBlock{
    self.myBlock = ^{
        [self doSomething];     // Capturing a strong reference to self
                                // Create a strong reference cycle
    };
}

- (void)doSomething{
    // do something
}

在上面的代码中,编译器会在[self doSomething]处发出警告,提醒循环引用。更复杂的示例可能涉及到对象间的多个循环引用,从而使其更难以诊断。

为了避免这个问题,最好的方法是捕获一个弱引用的self

- (void)configureMyBlock{
    ... 
    ViewController * __weak weakSelf = self;
    self.myBlock = ^{
        [weakSelf doSomething]; // Capture the weak reference to avoid the reference cycle
    };
}

- (void)doSomething{
    // do something
}

通过捕获self的弱指针,myBlockViewController对象成为弱引用。如果在调用块之前释放ViewController对象,weakSelf指针会被设为nil

__weak相反的是__strong,因为__strong是默认属性,所以不需要明确指出。

如果在块内多次用到weakSelf,第一次调用weakSelfweakSelf存在,但后面再次调用weakSelf时,weakSelf可能已被释放,这时就需要把weakSelf转换为强引用类型vc,不再需要时需要手动释放vc。如下所示:

    ViewController * __weak weakSelf = self;
    ViewController *vc = weakSelf;
    if (vc) {
        [self.propertyAnimator addCompletion:^(UIViewAnimatingPosition finalPosition) {
            [vc.startStopButton setTitle:@"Start" forState:UIControlStateNormal];
            vc.startStopButton.enabled = NO;
            vc.pauseButton.enabled = NO;
            vc.restartButton.enabled = YES;
        }];
    }
    vc = nil;

上述代码来自UIViewPropertyAnimator的使用一文中的demo

在上面代码中,需要先将weakSelf转换为强引用的vc,判断vc是否存在。不能先判断weakSelf是否存在,后转换为vc,因为可能判断时weakSelf存在,转换时已被释放。

总结

块功能强大,可以让代码更有条理、易于控制,但对于某些任务,使用委托或其它编程方法可能更为高效。从现在开始,我们可以在代码中更多使用块,并在更高级别上利用Objective-C。

这篇文章只介绍了 block 捕获变量、修改变量的基本用法。如果想要了解 block 本质及底层原理,请查看我的另一篇文章:Block的本质

Demo名称:Block
源码地址:https://github.com/pro648/BasicDemos-iOS

参考资料:

  1. Working with Blocks
  2. Introduction to Objective-C Blocks
  3. 一篇文章看懂iOS代码块Block
  4. “This function declaration is not a prototype” warning in Xcode 9

欢迎更多指正:https://github.com/pro648/tips/wiki

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 202,905评论 5 476
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,140评论 2 379
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 149,791评论 0 335
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,483评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,476评论 5 364
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,516评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,905评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,560评论 0 256
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,778评论 1 296
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,557评论 2 319
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,635评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,338评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,925评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,898评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,142评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 42,818评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,347评论 2 342

推荐阅读更多精彩内容