Package convex.core.lang

Class Reader

java.lang.Object

convex.core.lang.Reader

public class Reader
extends Object

Reader implementation which reads source code and produces a tree of parsed objects. Supports reading in either raw form (ACell) mode or wrapping with Syntax Objects. The latter is required for source references etc. "Talk is cheap. Show me the code." - Linus Torvalds

Constructor Summary

Constructors

Constructor	Description
Reader()

Method Summary

Modifier and Type	Method	Description
static ACell	read(Reader source)	Parses an expression and returns a form as an Object
static <R extends ACell> R	read(String source)	Parses an expression and returns a canonical Cell representing a form
static AList<ACell>	readAll(String source)	Parses an String to returns a list of raw forms
static ACell	readResource(String path)
static ACell	readResourceAsData(String path)
static Syntax	readSyntax(String source)	Parses an expression and returns a Syntax object

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

Reader

public Reader()

Method Details

readSyntax

public static Syntax readSyntax(String source)

Parses an expression and returns a Syntax object

Parameters:

source - Source to read as a Syntax object

Returns:

Parsed form

readResource

public static ACell readResource(String path)

readResourceAsData

public static ACell readResourceAsData(String path)
                                throws IOException

Throws:

IOException

readAll

public static AList<ACell> readAll(String source)

Parses an String to returns a list of raw forms

Parameters:

source - Convex data to read

Returns:

List of forms read

read

public static ACell read(Reader source)
                  throws IOException

Parses an expression and returns a form as an Object

Parameters:

source - Reader instance to get expression from

Returns:

Parsed form (may be nil)

Throws:

IOException

read

public static <R extends ACell> R read(String source)

Parses an expression and returns a canonical Cell representing a form

Parameters:

source - Java source string to read

Returns:

Parsed form (may be nil)