mago-syntax 1.20.1

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

use crate::T;
use crate::ast::ast::FunctionLikeParameter;
use crate::ast::ast::FunctionLikeParameterDefaultValue;
use crate::ast::ast::FunctionLikeParameterList;
use crate::error::ParseError;
use crate::parser::Parser;

impl<'input, 'arena> Parser<'input, 'arena> {
    pub(crate) fn parse_optional_function_like_parameter_list(
        &mut self,
    ) -> Result<Option<FunctionLikeParameterList<'arena>>, ParseError> {
        Ok(match self.stream.peek_kind(0)? {
            Some(T!["("]) => Some(self.parse_function_like_parameter_list()?),
            _ => None,
        })
    }

    pub(crate) fn parse_function_like_parameter_list(
        &mut self,
    ) -> Result<FunctionLikeParameterList<'arena>, ParseError> {
        let result = self.parse_comma_separated_sequence(T!["("], T![")"], Self::parse_function_like_parameter)?;

        Ok(FunctionLikeParameterList {
            left_parenthesis: result.open,
            parameters: result.sequence,
            right_parenthesis: result.close,
        })
    }

    pub(crate) fn parse_function_like_parameter(&mut self) -> Result<FunctionLikeParameter<'arena>, ParseError> {
        Ok(FunctionLikeParameter {
            attribute_lists: self.parse_attribute_list_sequence()?,
            modifiers: self.parse_modifier_sequence()?,
            hint: self.parse_optional_type_hint()?,
            ampersand: if self.stream.is_at(T!["&"])? { Some(self.stream.eat_span(T!["&"])?) } else { None },
            ellipsis: if self.stream.is_at(T!["..."])? { Some(self.stream.eat_span(T!["..."])?) } else { None },
            variable: self.parse_direct_variable()?,
            default_value: self.parse_optional_function_like_parameter_default_value()?,
            hooks: self.parse_optional_property_hook_list()?,
        })
    }

    fn parse_optional_function_like_parameter_default_value(
        &mut self,
    ) -> Result<Option<FunctionLikeParameterDefaultValue<'arena>>, ParseError> {
        Ok(if self.stream.is_at(T!["="])? {
            let equals = self.stream.eat_span(T!["="])?;
            Some(FunctionLikeParameterDefaultValue { equals, value: self.parse_expression()? })
        } else {
            None
        })
    }
}