vendor/symfony/expression-language/TokenStream.php line 59

  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\ExpressionLanguage;
  14. /**
  15.  * Represents a token stream.
  16.  *
  17.  * @author Fabien Potencier <fabien@symfony.com>
  18.  */
  19. class TokenStream
  20. {
  21.     public $current;
  23.     private array $tokens;
  24.     private int $position = 0;
  25.     private string $expression;
  27.     public function __construct(array $tokens, string $expression = '')
  28.     {
  29.         $this->tokens = $tokens;
  30.         $this->current = $tokens[0];
  31.         $this->expression = $expression;
  32.     }
  34.     /**
  35.      * Returns a string representation of the token stream.
  36.      */
  37.     public function __toString(): string
  38.     {
  39.         return implode("\n", $this->tokens);
  40.     }
  42.     /**
  43.      * Sets the pointer to the next token and returns the old one.
  44.      */
  45.     public function next()
  46.     {
  47.         ++$this->position;
  49.         if (!isset($this->tokens[$this->position])) {
  50.             throw new SyntaxError('Unexpected end of expression.', $this->current->cursor, $this->expression);
  51.         }
  53.         $this->current = $this->tokens[$this->position];
  54.     }
  56.     /**
  57.      * @param string|null $message The syntax error message
  58.      */
  59.     public function expect(string $type, string $value = null, string $message = null)
  60.     {
  61.         $token = $this->current;
  62.         if (!$token->test($type, $value)) {
  63.             throw new SyntaxError(sprintf('%sUnexpected token "%s" of value "%s" ("%s" expected%s).', $message ? $message.'. ' : '', $token->type, $token->value, $type, $value ? sprintf(' with value "%s"', $value) : ''), $token->cursor, $this->expression);
  64.         }
  65.         $this->next();
  66.     }
  68.     /**
  69.      * Checks if end of stream was reached.
  70.      */
  71.     public function isEOF(): bool
  72.     {
  73.         return Token::EOF_TYPE === $this->current->type;
  74.     }
  76.     /**
  77.      * @internal
  78.      */
  79.     public function getExpression(): string
  80.     {
  81.         return $this->expression;
  82.     }
  83. }