Struct full_moon::ast::Ast

pub struct Ast { /* private fields */ }

An abstract syntax tree, contains all the nodes used in the code

Implementations

impl Ast

pub fn update_positions(self) -> Self

Will update the positions of all the tokens in the tree Necessary if you are both mutating the tree and need the positions of the tokens

impl Ast

pub fn from_tokens(tokens: Vec<Token>) -> Result<Ast, AstError>

Create an Ast from the passed tokens. You probably want parse

Errors

If the tokens passed are impossible to get through normal tokenization, an error of Empty (if the vector is empty) or NoEof (if there is no eof token) will be returned.

More likely, if the tokens pass are invalid Lua 5.1 code, an UnexpectedToken error will be returned.

pub fn with_nodes(self, nodes: Block) -> Self

Returns a new Ast with the given nodes

pub fn with_eof(self, eof: TokenReference) -> Self

Returns a new Ast with the given EOF token

pub fn nodes(&self) -> &Block

The entire code of the function

assert_eq!(full_moon::parse("local x = 1; local y = 2")?.nodes().stmts().count(), 2);

pub fn nodes_mut(&mut self) -> &mut Block

The entire code of the function, but mutable

pub fn eof(&self) -> &TokenReference

The EOF token at the end of every Ast

Trait Implementations

impl Clone for Ast

fn clone(&self) -> Ast

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Ast

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Ast

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Node for Ast

fn start_position(&self) -> Option<Position>

The start position of a node. None if can’t be determined

fn end_position(&self) -> Option<Position>

The end position of a node. None if it can’t be determined

fn similar(&self, other: &Self) -> bool

Whether another node of the same type is the same as this one semantically, ignoring position

fn tokens(&self) -> Tokens<'_>

The token references that comprise a node

fn range(&self) -> Option<(Position, Position)>

The full range of a node, if it has both start and end positions

fn surrounding_trivia(&self) -> (Vec<&Token>, Vec<&Token>)

The tokens surrounding a node that are ignored and not accessible through the node’s own accessors. Use this if you want to get surrounding comments or whitespace. Returns a tuple of the leading and trailing trivia.

impl Serialize for Ast

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>where __S: Serializer,

Serialize this value into the given Serde serializer.