gudusoft.gsqlparser.ir.semantic

Class SourceSpan

Object

gudusoft.gsqlparser.ir.semantic.SourceSpan

public final class SourceSpan
extends Object

Half-open source-text range, [startLine:startColumn, endLine:endColumn). Used by Diagnostic to point at the offending AST node when a reject site has one in scope.

startLine / startColumn mark the first character of the anchor (1-based as populated by GSP's lexer via TSourceToken.lineNo / TSourceToken.columnNo). endLine / endColumn mark the position one past the last character. For a single-line single-token anchor of length L, endColumn == startColumn + L. Multi-line tokens (e.g. triple-quoted strings) are handled by counting newlines in the end token's text.

The class is intentionally null-tolerant at the factory level: of(TParseTreeNode) returns null when the node or either of its boundary tokens is null. Diagnostic factories pass this null through to Diagnostic.getSpan() unchanged.

API status: read-only consumption of analyzer-produced spans is part of Join Analysis Consumption Profile v1. Factories are producer-oriented and are outside that profile.

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
long	getEndColumn()
long	getEndLine()
long	getStartColumn()
long	getStartLine()
int	hashCode()
static SourceSpan	of(long startLine, long startColumn, long endLine, long endColumn) Construct an explicit half-open source span.
static SourceSpan	of(TParseTreeNode node) Derive a span from the AST node's start and end tokens.
static SourceSpan	of(TSourceToken start, TSourceToken end) Derive a span from explicit start / end tokens.
String	toString()

Methods inherited from class Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Method Detail

of

public static SourceSpan of(long startLine,
                            long startColumn,
                            long endLine,
                            long endColumn)

Construct an explicit half-open source span. Coordinates are 1-based, and the end must not precede the start.

of

public static SourceSpan of(TParseTreeNode node)

Derive a span from the AST node's start and end tokens. Null-safe: returns null when node is null or either boundary token is null.

of

public static SourceSpan of(TSourceToken start,
                            TSourceToken end)

Derive a span from explicit start / end tokens. End position is computed as one past the last character of end so the resulting interval is half-open [start, end).

Null-safe: returns null when either token is null.

getStartLine

public long getStartLine()

getStartColumn

public long getStartColumn()

getEndLine

public long getEndLine()

getEndColumn

public long getEndColumn()

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object