| ︙ | | |
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
|
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
|
+
+
-
+
|
#import "OFObject.h"
#ifdef OF_HAVE_THREADS
# import "threading.h"
#endif
OF_ASSUME_NONNULL_BEGIN
/*! @file */
@class OFDate;
@class OFRunLoop;
@class OFMutableDictionary OF_GENERIC(KeyType, ObjectType);
#if defined(OF_HAVE_THREADS) && defined(OF_HAVE_BLOCKS)
/*!
* @brief A block to be executed in a new thread.
*
* @return The object which should be returned when the thread is joined
*/
typedef id (^of_thread_block_t)(void);
typedef __nullable id (^of_thread_block_t)(void);
#endif
/*!
* @class OFThread OFThread.h ObjFW/OFThread.h
*
* @brief A class which provides portable threads.
*
|
| ︙ | | |
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
|
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
|
-
+
-
+
|
+ (void)terminate OF_NO_RETURN;
/*!
* @brief Terminates the current thread, letting it return the specified object.
*
* @param object The object which the terminated thread will return
*/
+ (void)terminateWithObject: (id)object OF_NO_RETURN;
+ (void)terminateWithObject: (nullable id)object OF_NO_RETURN;
# ifdef OF_HAVE_BLOCKS
/*!
* @brief Initializes an already allocated thread with the specified block.
*
* @param threadBlock A block which is executed by the thread
* @return An initialized OFThread.
*/
- initWithThreadBlock: (of_thread_block_t)threadBlock;
# endif
/*!
* @brief The main routine of the thread. You need to reimplement this!
*
* It can access the object passed to the threadWithObject or initWithObject
* method using the instance variable named object.
*
* @return The object the join method should return when called for this thread
*/
- (id)main;
- (nullable id)main;
/*!
* @brief This routine is exectued when the thread's main method has finished
* executing or terminate has been called.
*
* @note Be sure to call [super handleTermination]!
*/
|
| ︙ | | |
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
|
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
|
-
+
-
+
|
- (OFRunLoop*)runLoop;
/*!
* @brief Returns the name of the thread or nil if none has been set.
*
* @return The name of the thread or nik if none has been set
*/
- (OFString*)name;
- (nullable OFString*)name;
/*!
* @brief Sets the name for the thread.
*
* @param name The name for the thread
*/
- (void)setName: (OFString*)name;
- (void)setName: (nullable OFString*)name;
/*!
* @brief Returns the priority of the thread.
*
* @return The priority of the thread
*/
- (float)priority;
|
| ︙ | | |
249
250
251
252
253
254
255
|
251
252
253
254
255
256
257
258
259
|
+
+
|
* @note This has to be set before the thread is started!
*
* @param stackSize The stack size for the thread
*/
- (void)setStackSize: (size_t)stackSize;
#endif
@end
OF_ASSUME_NONNULL_END
|