GitHub/Basalt
1
0
Fork 0
Code Issues 28 Pull Requests 3 Actions Packages Projects Releases 9 Wiki Activity

Update Thread.md

Browse Source
This commit is contained in:
Robert Jelic
2022-07-02 22:49:26 +02:00
committed by GitHub
parent ae9a6ac605
commit 1f18db9965
1 changed files with 28 additions and 17 deletions
Download Patch File Download Diff File Expand all files Collapse all files

45
docs/objects/Thread.md
View File

@@ -1,9 +1,16 @@
Threads are "functions" you can execute simultaneously. Ofc the reality is, i am just using coroutine for that. But it works pretty good AND is very easy to use. Threads are being executed simultaneously.
<br> <br>
Here is a list of all available functions for threads: <br>
## start ## start
starts a new thread and executes the function starts a new thread and executes the function
#### Parameters:
1. `function` the function which should be executed
#### Returns:
1. `object` The object in use
#### Usage:
* Starts a new thread
```lua ```lua
local mainFrame = basalt.createFrame("myFirstFrame"):show() local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aThread = mainFrame:addThread("myFirstThread"):show() local aThread = mainFrame:addThread("myFirstThread"):show()
@@ -15,21 +22,15 @@ local function randomThreadFunction()
end end
aThread:start(randomThreadfunction) aThread:start(randomThreadfunction)
``` ```
#### Parameters:function func<br>
#### Returns: self<br>
## getStatus
gets the thread status
```lua
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aThread = mainFrame:addThread("myFirstThread"):show()
basalt.debug(aThread:getStatus()) -- returns "running", "normal", "suspended" or "dead"
```
#### Parameters: -<br>
#### Returns: string "running" - if its running, "normal" - is active but not running (waiting for a event), "suspended" - is suspended<br>
## stop ## stop
stops the thread stops the thread
#### Returns:
1. `object` The object in use
#### Usage:
* Stops the current running thread by clicking on a button
```lua ```lua
local mainFrame = basalt.createFrame("myFirstFrame"):show() local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aThread = mainFrame:addThread("myFirstThread"):show() local aThread = mainFrame:addThread("myFirstThread"):show()
@@ -41,7 +42,17 @@ local function randomThreadFunction()
end end
aThread:start(randomThreadfunction) aThread:start(randomThreadfunction)
local aButton = mainFrame:addButton("myFirstButton"):setText("Stop Thread"):onClick(function() aThread:stop() end):show() local aButton = mainFrame:addButton("myFirstButton"):setText("Stop Thread"):onClick(function() aThread:stop() end):show()
``` ```
#### Parameters: -<br>
#### Returns: self<br> ## getStatus
gets the current thread status
#### Returns:
1. `string` current status - ("running", "normal", "suspended", "dead")
#### Usage:
```lua
local mainFrame = basalt.createFrame("myFirstFrame"):show()
local aThread = mainFrame:addThread("myFirstThread"):show()
basalt.debug(aThread:getStatus())
```