NSThread 官方文档
@interface NSThread : NSObject
// 描述
当你想让Objective-C方法在它自己的执行线程中运行时,使用这个类。
当您需要执行一个很长的任务,但又不希望它阻塞应用程序其余部分的执行时,线程尤其有用。
特别是,您可以使用线程来避免阻塞应用程序的主线程,后者处理用户界面和与事件相关的操作。
线程还可以用于将大型作业划分为几个较小的作业,这可能会导致多核计算机上的性能提高。
NSThread类支持与NSOperation类似的语义,用于监视线程的运行时条件。
您可以使用这些语义来取消线程的执行,或确定线程是否仍在执行或已完成其任务。
取消线程需要线程代码的支持;有关更多信息,请参见cancel的描述。
您可以子类化NSThread并覆盖main方法来实现线程的主入口点。
如果覆盖main,则不需要通过调用super来调用继承的行为。
// 初始化NSThread对象
1、init
2、initWithTarget:selector:object:
启动一个线程
1、detachNewThreadSelector:toTarget:withObject:
2、start
3、main // 永远不要直接调用这个方法。您应该总是通过调用start方法来启动线程
// 停止一个线程
1、sleepUntilDate:
2、sleepForTimeInterval:
3、exit // 应该避免调用此方法,因为它不会让线程有机会清理它在执行期间分配的任何资源
4、cancel
// 确定线程的执行状态
1、executing
2、finished
3、cancelled
// 处理主线程
1、isMainThread
2、mainThread
// 查询环境
1、isMultiThreaded
2、currentThread
3、callStackReturnAddresses
4、callStackSymbols
// 处理线程属性
1、threadDictionary
2、NSAssertionHandlerKey
3、name
4、stackSize
// 优先级线程的工作
1、qualityOfService、NSQualityOfService
2、threadPriority类方法和实例方法
3、setThreadPriority:
// 通知
1、NSDidBecomeSingleThreadedNotification
2、NSThreadWillExitNotification
3、NSWillBecomeMultiThreadedNotification
// 初始化器
1、initWithBlock:
- (instancetype)initWithBlock:(void (^)(void))block;
// 类方法
1、detachNewThreadWithBlock:
+ (void)detachNewThreadWithBlock:(void (^)(void))block;
initWithTarget:selector:object:(实例方法)
返回用给定参数初始化的NSThread对象
- (instancetype)initWithTarget:(id)target selector:(SEL)selector object:(id)argument;
// target
选择器指定的消息发送到的对象。
// selector
要发送到目标的消息的选择器。
这个选择器必须只接受一个参数,并且不能有返回值。
// argument
传递给目标的单个参数。可能是nil。
// 描述
对象target和argument在分离线程执行期间被保留。
它们在线程最终退出时被释放。
detachNewThreadSelector:toTarget:withObject:(类方法)
分离一个新线程,并使用指定的选择器作为线程入口点
+ (void)detachNewThreadSelector:(SEL)selector toTarget:(id)target withObject:(id)argument;
// selector
要发送到目标的消息的选择器。这个选择器必须只接受一个参数,并且不能有返回值。
// target
将在新线程上接收消息selector的对象。
// argument
传递给目标的单个参数。可能是nil。
// 描述
对象target和argument在分离线程执行期间被保留,然后释放。
一旦aTarget完成执行aSelector方法,分离的线程就会退出(使用exit类方法)。
如果此线程是应用程序中分离的第一个线程,则此方法将对象为nil的nswillbecomtithreadednotification发布到the default notification center。
sleepUntilDate:(类方法)
阻塞当前线程,直到指定的时间为止。
+ (void)sleepUntilDate:(NSDate *)date;
// date
恢复处理的时间
// 要点
当线程被阻塞时,不会发生runloop处理。
sleepForTimeInterval:(类方法)
在给定的时间间隔内休眠线程。
+ (void)sleepForTimeInterval:(NSTimeInterval)ti;
// ti
睡眠的持续时间。
// 要点
当线程被阻塞时,不会发生runloop处理。
exit
终止当前线程。
+ (void)exit;
// 讨论
此方法使用currentThread类方法访问当前线程。
在退出线程之前,该方法将NSThreadWillExitNotification与退出到the default notification center的线程一起发布。
因为通知是同步发送的,所以NSThreadWillExitNotification的所有观察者都保证在线程退出之前收到通知。
应该避免调用此方法,因为它不会让线程有机会清理它在执行期间分配的任何资源。
cancel
更改接收器的已取消状态,以指示它应该退出。
- (void)cancel;
// 讨论
该方法的语义与NSOperation相同。
此方法设置接收方中的状态信息,然后通过cancelled属性反映这些信息。
支持取消的线程应该定期调用cancelled的方法来确定该线程实际上是否已被取消,如果已被取消则退出。
有关取消和操作对象的更多信息,请参见NSOperation。
确定线程的执行状态
指示接收器是否正在执行的布尔值。
如果接收者正在执行,则为YES,否则为NO。
@property(readonly, getter=isExecuting) BOOL executing;
一个布尔值,指示接收方是否已完成执行。
如果接收者已经执行完毕,则为YES,否则为NO。
@property(readonly, getter=isFinished) BOOL finished;
一个布尔值,指示是否取消接收方。
@property(readonly, getter=isCancelled) BOOL cancelled;
如果收件人已被取消,则为“是”,否则为“否”。
如果您的线程支持取消,它应该定期检查此属性,如果返回YES,则退出。
处理主线程
返回一个布尔值,该值指示当前线程是否为主线程。
@property(class, readonly) BOOL isMainThread;
如果当前线程是主线程,则为YES,否则为NO。
一个布尔值,指示接收方是否为主线程。
@property(readonly) BOOL isMainThread;
如果接收方是主线程,则为YES,否则为NO。
返回代表主线程的NSThread对象。
@property(class, readonly, strong) NSThread *mainThread;
查询环境
返回应用程序是否是多线程的。
+ (BOOL)isMultiThreaded;
如果曾经使用detachNewThreadSelector:toTarget:withObject:或start将线程与主线程分离,则应用程序被认为是多线程的。
如果使用非cocoa API(如POSIX或多处理服务API)分离应用程序中的线程,该方法仍然可以返回NO。
要将应用程序视为多线程,分离的线程不必当前运行—此方法仅指示是否派生了单个线程。
返回表示当前执行线程的线程对象。
@property(class, readonly, strong) NSThread *currentThread;
返回一个包含调用堆栈返回地址的数组。
@property(class, readonly, copy) NSArray<NSNumber *> *callStackReturnAddresses;
包含调用堆栈返回地址的数组。每个元素都是一个包含NSUInteger值的NSNumber对象。
返回一个包含调用堆栈符号的数组。
@property(class, readonly, copy) NSArray<NSString *> *callStackSymbols;
包含调用堆栈符号的数组。
每个元素都是一个NSString对象,其值的格式由backtrace_symbols()函数决定。
有关更多信息,请参见backtrace_symbols(3) macOS开发工具手册页。
返回值描述调用此方法时当前线程的调用堆栈回溯。
处理线程属性
线程对象的字典。
@property(readonly, retain) NSMutableDictionary *threadDictionary;
您可以使用返回的字典来存储特定于线程的数据。
在对NSThread对象进行任何操作期间都不使用线程字典——它只是一个可以存储任何有趣数据的地方。
例如,Foundation使用它存储线程的默认NSConnection和NSAssertionHandler实例。
您可以为字典定义自己的键。
NSString *const NSAssertionHandlerKey;
// 接收者的名字
@property(copy) NSString *name;
// 接收方的堆栈大小,以字节为单位。
@property NSUInteger stackSize;
这个值必须是字节数和4KB的倍数。
要更改堆栈大小,必须在启动线程之前设置此属性在线程启动后设置堆栈大小会更改属性大小(由stackSize方法反映),但不会影响为线程预留的实际页面数量。
优先级线程的工作
@property NSQualityOfService qualityOfService;
typedef NS_ENUM(NSInteger, NSQualityOfService) {
NSQualityOfServiceUserInteractive = 0x21,
NSQualityOfServiceUserInitiated = 0x19,
NSQualityOfServiceUtility = 0x11,
NSQualityOfServiceBackground = 0x09,
NSQualityOfServiceDefault = -1
} API_AVAILABLE(macos(10.10), ios(8.0), watchos(2.0), tvos(9.0));
用于表示工作的性质和对系统的重要性。
当存在资源争用时,使用高质量服务类的工作要比使用低质量服务类的工作获得更多的资源。
// 用于直接参与提供交互式UI的工作。例如,处理控制事件或绘制到屏幕。
NSQualityOfServiceUserInteractive
// 用于执行用户明确请求的工作,并且必须立即显示结果,以便进行进一步的用户交互。
// 例如,在用户在消息列表中选择电子邮件后加载它。
NSQualityOfServiceUserInitiated
// 用于执行用户不太可能立即等待结果的工作。
// 这项工作可能是由用户请求的,也可能是自动启动的,并且通常在用户可见的时间范围内使用非模式进度指示器进行操作。
// 例如,定期更新内容或批量文件操作,如媒体导入。
NSQualityOfServiceUtility
// 用于非用户发起或不可见的工作。
// 一般来说,用户甚至不知道正在进行这项工作。
// 例如,预取内容、搜索索引、备份或与外部系统同步数据。
NSQualityOfServiceBackground
// 表示没有显式的服务质量信息。
// 只要可能,就从现有资源确定适当的服务质量。
// 否则,将使用NSQualityOfServiceUserInteractive和NSQualityOfServiceUtility之间的一些服务质量级别。
NSQualityOfServiceDefault
返回当前线程的优先级。
+ (double)threadPriority;
接收方的优先级
@property double threadPriority;
当前线程的优先级,由0.0到1.0之间的浮点数指定,其中1.0是最高优先级。
此范围内的优先级映射到操作系统的优先级值。
一个“典型的”线程优先级可能是0.5,但是因为优先级是由内核决定的,所以不能保证这个值实际上是什么。
设置当前线程的优先级。
+ (BOOL)setThreadPriority:(double)p;
// p
新优先级,用浮点数从0.0指定到1.0,其中1.0是最高优先级。
// 返回值
如果优先级分配成功,则为YES,否则为NO。
此范围内的优先级映射到操作系统的优先级值。
通知
没有实现。
const NSNotificationName NSDidBecomeSingleThreadedNotification;
当NSThread对象在线程退出之前收到退出消息时,它会发布这个通知。
为接收此通知而调用的观察者方法在退出线程之前在退出线程中执行。
const NSNotificationName NSThreadWillExitNotification;
通知对象是正在退出的NSThread对象。此通知不包含userInfo字典。
当第一个线程与当前线程分离时发布。
NSThread类最多发布一次这个通知——第一次使用detachNewThreadSelector:toTarget:withObject:或start方法分离线程。
这些方法的后续调用不会发布此通知。
此通知的观察者的通知方法在主线程中调用,而不是在新线程中调用。
观察者通知方法总是在新线程开始执行之前执行。
const NSNotificationName NSWillBecomeMultiThreadedNotification;
此通知不包含通知对象或userInfo字典。