GCD任务操作__block.h

block.h包含如下方法:

block.h

/*dispatch_block_flags_t 的枚举*/
DISPATCH_ENUM(dispatch_block_flags, unsigned long,
    DISPATCH_BLOCK_BARRIER
            DISPATCH_ENUM_API_AVAILABLE(macos(10.10), ios(8.0)) = 0x1,
    DISPATCH_BLOCK_DETACHED
            DISPATCH_ENUM_API_AVAILABLE(macos(10.10), ios(8.0)) = 0x2,
    DISPATCH_BLOCK_ASSIGN_CURRENT
            DISPATCH_ENUM_API_AVAILABLE(macos(10.10), ios(8.0)) = 0x4,
    DISPATCH_BLOCK_NO_QOS_CLASS
            DISPATCH_ENUM_API_AVAILABLE(macos(10.10), ios(8.0)) = 0x8,
    DISPATCH_BLOCK_INHERIT_QOS_CLASS
            DISPATCH_ENUM_API_AVAILABLE(macos(10.10), ios(8.0)) = 0x10,
    DISPATCH_BLOCK_ENFORCE_QOS_CLASS
            DISPATCH_ENUM_API_AVAILABLE(macos(10.10), ios(8.0)) = 0x20,
);

一、创建 block有两个方法

/**
 创建block方法

 @param flags 用来设置 block 的标记 (类型为 dispatch_block_flags_t 的枚举)
 @param block 用来设置具体的任务
 @return 返回dispatch_block_t类型的block
 */
dispatch_block_t
dispatch_block_create(dispatch_block_flags_t flags, dispatch_block_t block);
/**
 创建block方法

 @param flags 用来设置 block 的标记 
 @param qos_class 
 @param relative_priority 优先级
 @param block 用来设置具体的任务
 @return 返回dispatch_block_t类型的block
 */
dispatch_block_t
dispatch_block_create_with_qos_class(dispatch_block_flags_t flags,
dispatch_qos_class_t qos_class, int relative_priority,dispatch_block_t block);

说明：dispatch_block_create_with_qos_class相比于 dispatch_block_create 函数，这种方式在创建 block 的同时可以指定了相应的优先级。dispatch_qos_class_t 是 qos_class_t 的别名，定义如下：

#if __has_include()
typedef qos_class_t dispatch_qos_class_t;
#else
typedef unsigned int dispatch_qos_class_t;
#endif

其中qos_class_t是一个枚举类型：

__QOS_ENUM(qos_class, unsigned int,
    QOS_CLASS_USER_INTERACTIVE
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x21,
    QOS_CLASS_USER_INITIATED
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x19,
    QOS_CLASS_DEFAULT
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x15,
    QOS_CLASS_UTILITY
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x11,
    QOS_CLASS_BACKGROUND
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x09,
    QOS_CLASS_UNSPECIFIED
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x00,
);
/*
1、QOS_CLASS_USER_INTERACTIVE
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x21,
表示任务会被立即执行，在响应事件之后更新 UI，来提供好的用户体验。（不要放太耗时操作）。
2、QOS_CLASS_USER_INITIATED
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x19,
表示任务由 UI 发起异步执行。适用场景是需要获取结果同时又可以继续交互的时候。(不要放太耗时操作)
3、QOS_CLASS_DEFAULT
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x15,
默认优先级 (不是给程序员使用的，用来重置对列使用的)
4、QOS_CLASS_UTILITY
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x11,
表示需要长时间运行的任务 (耗时操作，可以使用这个选项)
5、QOS_CLASS_BACKGROUND
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x09,
表示用户不需要知道任务什么时候完成。选择这个选项速度慢得令人发指，非常不利于调试！（后台）
6、QOS_CLASS_UNSPECIFIED
            __QOS_CLASS_AVAILABLE(macos(10.10), ios(8.0)) = 0x00,
未指定
*/

举例说明：

dispatch_queue_t quene = dispatch_queue_create("com.Maker", DISPATCH_QUEUE_CONCURRENT);

dispatch_block_t qosBlock = dispatch_block_create_with_qos_class(0, QOS_CLASS_USER_INTERACTIVE, 0, ^{
    for (int i = 0; i < 100; i++) {
        NSLog(@"%@",[NSString stringWithFormat:@"qos_class 做一些事情..., %d",i]);
    }
});
dispatch_async(quene, qosBlock);

dispatch_block_t block = dispatch_block_create(0, ^{
    for (int i = 0; i < 100; i++) {
        NSLog(@"%@",[NSString stringWithFormat:@"做一些事情..., %d",i]);
    }
});
dispatch_async(quene, block);

二、监听任务（block）执行

假如我们需要等待特定任务（block） 执行完成之后，再去执行其他任务（block）。
可以通过两种方式实现：wait 和 notify。

/**
 等待block执行

 @param block 等待的block
 @param timeout 等待时间 （DISPATCH_TIME_FOREVER，这表示函数会一直等待 block 执行完）
 @return 返回long类型结果 （执行 block 所需的时间小于 timeout，则返回 0，否则返回非 0 值）
 */
long
dispatch_block_wait(dispatch_block_t block, dispatch_time_t timeout);
/**
 block通知

 @param block 用来设置 block 的标记 
 @param queue 
 @param notification_block 
 */
void
dispatch_block_notify(dispatch_block_t block, 
dispatch_queue_t queue,dispatch_block_t notification_block);

参数需要设置的 block 和等待时间 timeout。
timeout 参数表示函数在等待 block 执行完毕时，应该等待多久。如果执行 block 所需的时间小于 timeout，则返回 0，否则返回非 0 值。此参数也可以取常量 DISPATCH_TIME_FOREVER，这表示函数会一直等待 block 执行完，而不会超时。可以使用 dispatch_time 函数和 DISPATCH_TIME_NOW 常量来方便的设置具体的超时时间。如果任务（block）执行完成，dispatch_block_wait 就会立即返回。
注意不能使用 dispatch_block_wait 来等待同一个 block 的多次执行全部结束；这种情况可以考虑使用 dispatch_group_wait 来解决。也不能在多个线程中，同时等待同一个任务（block）的结束。同一个任务（block）只能执行一次，被等待一次。
注意：因为 dispatch_block_wait 会阻塞当前线程，所以不应该放在主线程中调用。
实例说明一：

dispatch_queue_t quene = dispatch_queue_create("com.Maker", DISPATCH_QUEUE_CONCURRENT);
dispatch_async(quene, ^{
    dispatch_queue_t allTasksQueue = dispatch_queue_create("allTasksQueue", DISPATCH_QUEUE_CONCURRENT);
    dispatch_block_t block = dispatch_block_create(0, ^{
        NSLog(@"开始执行");
        sleep(3.0);
        NSLog(@"结束执行");
    });
    dispatch_async(allTasksQueue, block);
    // 等待时长，10s 之后超时
    dispatch_time_t timeout = dispatch_time(DISPATCH_TIME_FOREVER, (int64_t)(10 * NSEC_PER_SEC));
    long resutl = dispatch_block_wait(block, timeout);
    if (resutl == 0) {
        NSLog(@"执行成功");
    } else {
        NSLog(@"执行超时");
    }
});

实例说明二：

dispatch_queue_t allTasksQueue = dispatch_queue_create("allTasksQueue", DISPATCH_QUEUE_CONCURRENT);
dispatch_block_t block = dispatch_block_create(0, ^{
    NSLog(@"开始执行任务");
    sleep(3.0);
    NSLog(@"结束执行任务");
});
dispatch_async(allTasksQueue, block);
dispatch_block_notify(block, allTasksQueue, ^{
    NSLog(@"任务已经执行完毕");
});

三、取消任务（block）执行

/**
 取消任务（block）

 @param block 指定取消的任务（block）
 */
void
dispatch_block_cancel(dispatch_block_t block);

/**
 判断任务（block）是否取消

 @param block 指定任务（block）
 @return 如果被取消非0，如果没取消，则为0
 */
long
dispatch_block_testcancel(dispatch_block_t block);

举例说明：

dispatch_queue_t queue = dispatch_queue_create("com.Maker", DISPATCH_QUEUE_SERIAL);
dispatch_block_t firstTask = dispatch_block_create(0, ^{
    NSLog(@"开始第一个任务");
    sleep(3.0);
    NSLog(@"结束第一个任务");
});
dispatch_block_t secondTask = dispatch_block_create(0, ^{
    NSLog(@"开始第二个任务");
    sleep(4.0);
    NSLog(@"结束第二个任务");
});
dispatch_async(queue, firstTask);
dispatch_async(queue, secondTask);
    
dispatch_block_cancel(firstTask);
NSLog(@"尝试取消第一个任务");
long code =  dispatch_block_testcancel(firstTask);
if (code == 0) {
    NSLog(@"已经开始执行第一个任务");
}
else {
    NSLog(@"已经取消第一个任务");
}
dispatch_block_cancel(secondTask);
NSLog(@"尝试取消第二个任务");