Multiuser Lingo Dictionary > Multiuser Lingo Dictionary > frame() (thread) |  |

frame() (thread)

Syntax

    whichThread.frame(frameNumber)

Description

Multiuser Server server-side debugging function; returns a stack frame reference. Each nested handler call (a handler called from within another handler) produces a stack frame. Frames are numbered from 1 to `n`, with 1 being the current stack frame, 2 being the frame corresponding to the handler that called the current handler, and so on.

The `frame()` function is useful for creating references to variables and line numbers.

Example

To refer to the handler two levels above the current handler (the current handler is frame 1) use a `frameNumber` of 3.

    frameRef = testThread.frame(3)

See also

`frameCount (thread)`, `line()`, `variable()`