%PDF-
%PDF-
Mini Shell
Mini Shell
<?php
/**
* This file is part of the Nette Framework (https://nette.org)
* Copyright (c) 2004 David Grudl (https://davidgrudl.com)
*/
declare(strict_types=1);
namespace Nette\Utils;
/**
* Traversing helper.
* @deprecated use similar Nette\Tokenizer\Stream
*/
class TokenIterator
{
/** @var array */
public $tokens;
/** @var int */
public $position = -1;
/** @var array */
public $ignored = [];
/**
* @param array[] $tokens
*/
public function __construct(array $tokens)
{
trigger_error(self::class . ' is deprecated, use similar Nette\Tokenizer\Stream', E_USER_DEPRECATED);
$this->tokens = $tokens;
}
/**
* Returns current token.
*/
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
*/
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[]
*/
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[]
*/
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)
|| (isset($token[Tokenizer::TYPE]) && 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
}
/**
* @return static
*/
public function reset(): self
{
$this->position = -1;
return $this;
}
/**
* Moves cursor to next token.
*/
protected function next(): void
{
$this->position++;
}
/**
* Looks for (first) (not) wanted tokens.
* @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];
$type = $token[Tokenizer::TYPE] ?? null;
if (
!$wanted
|| (
in_array($token[Tokenizer::VALUE], $wanted, true)
|| in_array($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($type, $this->ignored, true)) {
return $res;
}
$pos += $prev ? -1 : 1;
} while (true);
}
}
Zerion Mini Shell 1.0