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(<sys/qos.h>)
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(@"尝试取消第二个任务");
