blob: 0f04e12293b0071bf8b482f806a5a293b3432169 (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
|
## async
thread.async(function(res))
despite the name, this function provides a new state running under a new thread. coroutines would be more what you are looking for for async
the argument function is executed by the thread until it has been completed. the res paramater is a function that takes any number of arguments and sets them as the value for the thread:await() call, and kills the thread (safely)
the reason for the res function it because lua_call (in the c api) requires a number or return values before you run the function
### async:await
async:await()
pauses the current thread until the selected thread exits, or calls res(), the return value is whatever the thread passed to res
### async:kill
async:kill()
kills the thread, this may close it in an unsafe way, and should be avoided
### async:close
async:close()
kills the thread in a more safe manor, should be preferred in most cases. however it is best to let the thread exit itself
some systems may not support this (pthread_cancel) and so this function will call async:kill() in cases where it cant. android is one of the main ones
### async:clean
async:clean()
calls the __gc metamethod, will call async:close() if it is still running
|
