gudusoft.gsqlparser.lineage.v2.producer

Class SourceText

Object

gudusoft.gsqlparser.lineage.v2.producer.SourceText

public final class SourceText
extends Object

The decoded text of one source unit and the two coordinate systems that meet in it.

• GSP's lexer numbers lines and columns in UTF-16 code units, and ends a line at LF, CR LF or a lone CR (TCustomLexer.readln). Re-parsed text (routine bodies, dynamic SQL) has its token lines and columns shifted into the parent text while TSourceToken.offset stays relative to the inner text, so only the (line, column) pair is trusted: lexerOffset(long, long) turns it into a UTF-16 offset of this text.
• SQL-LR positions (Position) count lines from 1 with LF as the line end, columns in code points from 1, and offsets in UTF-8 bytes from 0, as the reference validator checks them (conformance/run.py, M1 SemanticStage.SourceText). position(int) gives that triple for a UTF-16 offset.

Immutable.

Since:

4.2.17

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	SourceText.Position A SQL-LR position.

Constructor Summary

Constructors

Constructor and Description
SourceText(String text)

Method Summary

Modifier and Type	Method and Description
String	getText()
int	lexerOffset(long line1, long column1) The UTF-16 offset of a lexer (line, column), or -1 when the pair lies outside the text.
boolean	matches(int utf16Offset, String fragment) Whether fragment occurs in the text at utf16Offset.
SourceText.Position	position(int utf16Offset) The SQL-LR position of a UTF-16 offset, or null when the offset is outside the text or inside a surrogate pair.
int	utf8Length() The UTF-8 length of the text.

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SourceText

public SourceText(String text)

Method Detail

getText

public String getText()

utf8Length

public int utf8Length()

The UTF-8 length of the text.

lexerOffset

public int lexerOffset(long line1,
                       long column1)

The UTF-16 offset of a lexer (line, column), or -1 when the pair lies outside the text. Column c of a line is the offset lineStart + c - 1; a column past the end of its line is outside.

position

public SourceText.Position position(int utf16Offset)

The SQL-LR position of a UTF-16 offset, or null when the offset is outside the text or inside a surrogate pair.

matches

public boolean matches(int utf16Offset,
                       String fragment)

Whether fragment occurs in the text at utf16Offset.