AST Construction

Contrary to the parse tree, which is very closely tied to the grammar by its direct relation to the grammar rules, the Abstract Syntax Tree you might want to construct for your language heavily depends on your exact project needs. This is why parboiled takes a very open and flexible approach to supporting it.
There are absolutely no restrictions on the type of your AST nodes. parboiled does provide a number of immutable and mutable base classes you might choose to use, however, there is nothing that forces you to do so. Take a look at the org.parboiled.trees package to get started.

Typically you would use the parser value stack as the “work bench” for constructing your AST. If you work with parboiled for Java you should take a look at the Calculators examples to get an understanding of how this might be done.
For parboiled for Scala the JSON Parser examples are worth a look.

Content

Introduction
... Motivation
... Features
... Simple Java Example
... Simple Scala Example
... RegEx vs. parboiled vs. Parser Generators
... Projects using parboiled
Installation
Concepts
... The Big Picture
... The Rule Tree
... The Value Stack
... The Parse Tree
... AST Construction
... Parse Error Handling
parboiled for Java
... Rule Construction in Java
... Parser Action Expressions
... Working with the Value Stack
... Action Variables
... Parser Extension in Detail
... Style Guide
... Java Examples
...... ABC Grammar
...... Calculators
...... Time Parser
...... Java Parser
...... Markdown processor
parboiled for Scala
... Rule Construction in Scala
... Parser Actions in Scala
... Parser Testing in Scala
... Scala Examples
...... Simple Calculator
...... JSON Parser
Advanced Topics
... Handling Whitespace
... Parsing Performance Tuning
... Indentation Based Grammars
... The ProfilingParseRunner
... Grammar and Parser Debugging
... Thread Safety
Building parboiled
parboiled-core Javadoc API
parboiled-java Javadoc API
parboiled-scala Scaladoc API
Change Log
Patch Policy

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

AST Construction

Content

Clone this wiki locally