Difference between revisions of "MC-Basic:task.STATUS"
(Added "Main program") |
|||
| Line 12: | Line 12: | ||
This query returns the status of a task that is loaded in memory. The information returned will be in the following format: | This query returns the status of a task that is loaded in memory. The information returned will be in the following format: | ||
| − | State ''<state>'': ''<description>'' Error ''<last error number>'' Source ''<line of source code>'' | + | State ''<state>'': ''<description>'' Error ''<last error number>'' Source ''<line of source code>''<br> |
| − | + | <br> | |
| + | From 0.4.15.4 returns "Main program" line number, which represents the first frame in the function call stack<br> | ||
| + | State ''<state>'': ''<description>'' Error ''<last error number>'' Source ''<line of source code>'' Main program ''<line of source code>''<br> | ||
where ''<state>'' is one of the following:<br> | where ''<state>'' is one of the following:<br> | ||
Revision as of 12:47, 23 February 2016
This query returns the status of a task that is loaded in memory. The information returned will be in the following format:
State <state>: <description> Error <last error number> Source <line of source code>
From 0.4.15.4 returns "Main program" line number, which represents the first frame in the function call stack
State <state>: <description> Error <last error number> Source <line of source code> Main program <line of source code>
where <state> is one of the following:
1: Running
2: Stopped (due to IDLETASK)
4: Stopped due to run-time error
5: Terminated .
It can be seen momentary that state at:
1. Terminate program
2. Unload
7: Ready (after LOAD)
9: Task Kill Start .
10: Killed (after KILLTASK or END PROGRAM)
Syntax
?<task>.Status
Availability
All versions
Type
String
Range
Returned value: 1, 2, 4, 5, 7, 9, 10
Scope
Terminal
Limitations
Task must be loaded in memory
Examples
?MyTask.prg.Status