%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* This file is part of the Latte (https://latte.nette.org)
* Copyright (c) 2008 David Grudl (https://davidgrudl.com)
*/
declare(strict_types=1);
namespace Latte;
/**
* Traversing helper.
* @internal
*/
class TokenIterator
{
use Strict;
/** @var array<array{string, int, int}> */
public $tokens;
/** @var int */
public $position = -1;
/** @var int[] */
public $ignored = [];
/**
* @param array[] $tokens
*/
public function __construct(array $tokens)
{
$this->tokens = $tokens;
}
/**
* Returns current token.
* @return ?array{string, int, int}
*/
public function currentToken(): ?array
{
return $this->tokens[$this->position] ?? null;
}
/**
* Returns current token value.
*/
public function currentValue(): ?string
{
return $this->tokens[$this->position][Tokenizer::VALUE] ?? null;
}
/**
* Returns next token.
* @param int|string ...$args desired token type or value
* @return ?array{string, int, int}
*/
public function nextToken(...$args): ?array
{
return $this->scan($args, true, true); // onlyFirst, advance
}
/**
* Returns next token value.
* @param int|string ...$args desired token type or value
*/
public function nextValue(...$args): ?string
{
return $this->scan($args, true, true, true); // onlyFirst, advance, strings
}
/**
* Returns all next tokens.
* @param int|string ...$args desired token type or value
* @return array<array{string, int, int}>
*/
public function nextAll(...$args): array
{
return $this->scan($args, false, true); // advance
}
/**
* Returns all next tokens until it sees a given token type or value.
* @param int|string ...$args token type or value to stop before (required)
* @return array<array{string, int, int}>
*/
public function nextUntil(...$args): array
{
return $this->scan($args, false, true, false, true); // advance, until
}
/**
* Returns concatenation of all next token values.
* @param int|string ...$args token type or value to be joined
*/
public function joinAll(...$args): string
{
return $this->scan($args, false, true, true); // advance, strings
}
/**
* Returns concatenation of all next tokens until it sees a given token type or value.
* @param int|string ...$args token type or value to stop before (required)
*/
public function joinUntil(...$args): string
{
return $this->scan($args, false, true, true, true); // advance, strings, until
}
/**
* Checks the current token.
* @param int|string ...$args token type or value
*/
public function isCurrent(...$args): bool
{
if (!isset($this->tokens[$this->position])) {
return false;
}
$token = $this->tokens[$this->position];
return in_array($token[Tokenizer::VALUE], $args, true)
|| in_array($token[Tokenizer::TYPE], $args, true);
}
/**
* Checks the next token existence.
* @param int|string ...$args token type or value
*/
public function isNext(...$args): bool
{
return (bool) $this->scan($args, true, false); // onlyFirst
}
/**
* Checks the previous token existence.
* @param int|string ...$args token type or value
*/
public function isPrev(...$args): bool
{
return (bool) $this->scan($args, true, false, false, false, true); // onlyFirst, prev
}
/**
* Returns next expected token or throws exception.
* @param int|string ...$args desired token type or value
* @throws CompileException
*/
public function consumeValue(...$args): string
{
if ($token = $this->scan($args, true, true)) { // onlyFirst, advance
return $token[Tokenizer::VALUE];
}
$pos = $this->position + 1;
while (($next = $this->tokens[$pos] ?? null) && in_array($next[Tokenizer::TYPE], $this->ignored, true)) {
$pos++;
}
throw new CompileException($next ? "Unexpected token '" . $next[Tokenizer::VALUE] . "'." : 'Unexpected end.');
}
/** @return static */
public function reset()
{
$this->position = -1;
return $this;
}
/**
* Moves cursor to next token.
*/
protected function next(): void
{
$this->position++;
}
/**
* Looks for (first) (not) wanted tokens.
* @param array<int|string> $wanted of desired token types or values
* @return mixed
*/
protected function scan(
array $wanted,
bool $onlyFirst,
bool $advance,
bool $strings = false,
bool $until = false,
bool $prev = false
) {
$res = $onlyFirst ? null : ($strings ? '' : []);
$pos = $this->position + ($prev ? -1 : 1);
do {
if (!isset($this->tokens[$pos])) {
if (!$wanted && $advance && !$prev && $pos <= count($this->tokens)) {
$this->next();
}
return $res;
}
$token = $this->tokens[$pos];
if (
!$wanted
|| (
in_array($token[Tokenizer::VALUE], $wanted, true)
|| in_array($token[Tokenizer::TYPE], $wanted, true)
) ^ $until
) {
while ($advance && !$prev && $pos > $this->position) {
$this->next();
}
if ($onlyFirst) {
return $strings ? $token[Tokenizer::VALUE] : $token;
} elseif ($strings) {
$res .= $token[Tokenizer::VALUE];
} else {
$res[] = $token;
}
} elseif ($until || !in_array($token[Tokenizer::TYPE], $this->ignored, true)) {
return $res;
}
$pos += $prev ? -1 : 1;
} while (true);
}
}
Zerion Mini Shell 1.0