Cold Help System: Programming: ColdC Reference Manual: Functions: Task: task_info()

LIST task_info(INTEGER task_id)

This function returns full information on the task specified with the argument task_id. If the task does not exist, ~type is thrown. The returned list contains a minimum of seven elements, with subsequent elements defining the specific frames, these are:

1. INTEGER task id
2. INTEGER preempted
3. INTEGER datasize limit
4. INTEGER fork limit
5. INTEGER recursion limit
6. INTEGER objswap limit
7. INTEGER calldepth limit
8. LIST frame
9. ...

The second element preempted is true if this task was preempted, false if it was suspended. For more information on the limit elements, see config(). Remaining frame elements are eight element lists formatted as:

1. OBJNUM current object
2. OBJNUM caller
3. OBJNUM sender
4. OBJNUM user
5. INTEGER current opcode
6. INTEGER last opcode
7. INTEGER ticks remaining
8. SYMBOL method name

atomic() | caller() | cancel() | definer() | method() | pause() | refresh() | resume() | sender() | stack() | suspend() | task_id() | tasks() | this() | tick() | ticks_left() | set_user() | user() | pass() | task_info() | call_trace() | debug_callers()