github.com

classSqlToken

packages/ztd-query-core/src/Sql/SqlToken.php:23
final class SqlToken
Public API: explicitly declared with @visibility public.

One lexeme, with where it was written and how deeply it was nested.

The offset is what lets a rewriter put a statement back together around a token it wants to change, and the two depths are what let it tell a clause of the statement itself from the same words inside a subquery or a parenthesised list.

Inspect a token without losing its source offsetdoctest
$token = new \ZtdQuery\Sql\SqlToken(\ZtdQuery\Sql\SqlTokenKind::Word, 'SELECT', 2, 0, 0);
    $token->isKeyword('select') // => true
    $token->endOffset() // => 8
    $token->isTopLevel() // => true

Properties§

public string $text
source§
public int $offset
source§
public int $depth
source§
public int $bracketDepth
source§

Methods§

public function __construct(
    public SqlTokenKind $kind,
    public string $text,
    public int $offset,
    public int $depth,
    public int $bracketDepth,
)
source§

Parameters

$kindSqlTokenKindWhat kind of lexeme this is
$textstringThe lexeme, exactly as it was written
$offsetintWhere in the statement it starts
$depthintHow many parentheses it is inside
$bracketDepthintHow many brackets it is inside
public static function slice(
    string $sql,
    SqlTokenKind $kind,
    int $start,
    int $end,
    int $depth,
    int $bracketDepth,
): self
source§

Answers the token a stretch of the statement was read as.

Parameters

$sqlstringThe statement, as written
$kindSqlTokenKindWhat kind of lexeme the stretch was read as
$startintWhere the lexeme starts
$endintWhere it ends, just past its last byte
$depthintHow many parentheses it is inside
$bracketDepthintHow many brackets it is inside

Returns

self The lexeme, carrying the text it was written as
Test cases 3
Called from 2
Calls 2
public function isTopLevel(): bool
source§

Reports whether the lexeme belongs to the statement itself.

Returns

bool True when it is inside no parenthesis and no bracket
Test cases 3
public function isKeyword(string $keyword): bool
source§

Reports whether the lexeme is a given keyword.

SQL keywords are not case-sensitive, and neither is this.

Parameters

$keywordstringKeyword to test against

Returns

bool True when the lexeme is a word spelling that keyword
Test cases 3
Called from 7
Calls 2

Test cases 66§

Test cases that cover or call this symbol, from the coverage report and from the analyzed test sources.

Dedicated tests 10
Other tests reaching this symbol 56

Relations§

Instantiated in 1
Static calls 2
Method calls 14
Type checks 27
Type declarations 71