Table of Contents

Class HostDebugGotoParams

Namespace
RDCore.SDK.Platform.Components
Assembly
RDCore.SDK.dll

Request for rdcore/host/debug/goto: moves the program counter of the activation the program waits in (Set Next Statement), so that it goes on from there when it is resumed and not from where it stopped. Nothing runs.

[Method("rdcore/host/debug/goto", Direction.ClientToServer)]
public record HostDebugGotoParams : IRequest, IRequest<Unit>, IRequest<DebugGotoResult>, IBaseRequest, IEquatable<HostDebugGotoParams>
Inheritance
HostDebugGotoParams
Implements
IRequest
IRequest<Unit>
IRequest<DebugGotoResult>
IBaseRequest
Inherited Members

Remarks

A program does not always go on from exactly where it stopped: the person looking at it may move the point of execution, or the statement it was to run next may be one nobody wants run. The target is within the procedure the program waits in, which is the one whose code is in front of whoever asks - a line is a line of that procedure as it was when the program stopped. Anything else is Moved false, and the program still waits where it was.

Moving into or out of a block statement is moving as GoTo does: the state a block keeps (a With object, a For counter) is the state it had.

Part of the component protocol (RDCoreComponentProtocol), outside the SDK's compatibility promise.

Properties

Label

A statement label or line number of the procedure to go on from (100, Retry), as a shell that numbers its lines says it. Takes the place of Line.

public string? Label { get; init; }

Property Value

string

Line

The zero-based line of the source to go on from: the first statement that begins on it, or after it. Ignored when Label is given.

public int Line { get; init; }

Property Value

int

ModuleName

The programmatic name of the module Line is a line of, or null for the module of the procedure the program waits in. A line of another module is refused: the program can't go on from there.

public string? ModuleName { get; init; }

Property Value

string

Peek

Whether the request only asks where the program would go on from, and moves nothing: the answer is the one the move would be, with the line the move would land on - the first statement that begins on Line or after it, which a client offers as the target of the line.

public bool Peek { get; init; }

Property Value

bool