mago-syntax 1.25.0

A correct, fast, and memory-efficient PHP syntax implementation, including Lexer, Parser, AST, and utilities for Mago.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56

use crate::T;
use crate::ast::ast::Expression;
use crate::ast::ast::UnaryPrefix;
use crate::ast::ast::UnaryPrefixOperator;
use crate::ast::ast::Yield;
use crate::ast::ast::YieldFrom;
use crate::ast::ast::YieldPair;
use crate::ast::ast::YieldValue;
use crate::error::ParseError;
use crate::parser::Parser;
use crate::token::Precedence;

impl<'input, 'arena> Parser<'input, 'arena> {
    pub(crate) fn parse_yield(&mut self) -> Result<Yield<'arena>, ParseError> {
        let r#yield = self.expect_keyword(T!["yield"])?;
        let Some(next) = self.stream.lookahead(0)? else {
            return Ok(Yield::Value(YieldValue { r#yield, value: None }));
        };

        if T!["from"] == next.kind {
            return Ok(Yield::From(YieldFrom {
                r#yield,
                from: self.expect_keyword(T!["from"])?,
                iterator: self.arena.alloc(self.parse_expression_with_precedence(Precedence::YieldFrom)?),
            }));
        }

        if T!["&"] == next.kind {
            let ampersand_span = self.stream.eat_span(T!["&"])?;
            let referenced_expr = self.parse_expression_with_precedence(Precedence::Reference)?;
            let value = self.arena.alloc(Expression::UnaryPrefix(UnaryPrefix {
                operator: UnaryPrefixOperator::Reference(ampersand_span),
                operand: referenced_expr,
            }));

            return Ok(Yield::Value(YieldValue { r#yield, value: Some(value) }));
        }

        if !Self::is_at_start_of_expression(next.kind) {
            return Ok(Yield::Value(YieldValue { r#yield, value: None }));
        }

        let key_or_value = self.parse_expression_with_precedence(Precedence::Yield)?;

        Ok(if matches!(self.stream.peek_kind(0)?, Some(T!["=>"])) {
            Yield::Pair(YieldPair {
                r#yield,
                key: self.arena.alloc(key_or_value),
                arrow: self.stream.eat_span(T!["=>"])?,
                value: self.arena.alloc(self.parse_expression_with_precedence(Precedence::Yield)?),
            })
        } else {
            Yield::Value(YieldValue { r#yield, value: Some(self.arena.alloc(key_or_value)) })
        })
    }
}