polyglot.qq

Class QQ

java.lang.Object

polyglot.qq.QQ

Direct Known Subclasses:

QQ

public class QQ
extends java.lang.Object

Java language quasiquoter. This class contains methods for parsing strings into ASTs.

To use the class, invoke one of the parseT methods to create a Node of type T.

Each parseT method takes a format string as its first argument and some additional Object arguments. Each pattern in the format string is matched with its corresponding Object.

The format string may contain the following patterns:

• %s matches String (parsed as an identifier)
• %T matches Type or TypeNode
• %E matches Expr
• %S matches Stmt
• %D matches ClassDecl
• %M matches ClassMember
• %F matches Formal
• %LT matches List<Type> or List<TypeNode>
• %LE matches List<Expr>
• %LS matches List<Stmt>
• %LD matches List<ClassDecl>
• %LM matches List<ClassMember>
• %LF matches List<Formal>

These patterns are recognized as tokens by the lexer--surrounding the token with whitespace or parens may be needed to parse the string.

For example:

      Expr e;
      TypeNode t;
      Stmt s = qq.parseStmt("%T %s = new %T(%E);", t, "tmp", t, e);
  

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	DECL
protected static int	EXPR
protected ExtensionInfo	ext
protected static int	FILE
protected static int	MEMB
protected Position	pos
protected static int	STMT
protected static int	TYPE

Constructor Summary

Constructors

Constructor and Description
QQ(ExtensionInfo ext) Create a new quasiquoter to create AST nodes of the given language extension.
QQ(ExtensionInfo ext, Position pos) Create a new quasiquoter to create AST nodes of the given language extension, using pos for the position of the nodes created.

Method Summary

Methods

Modifier and Type	Method and Description
protected Lexer	lexer(java.lang.String fmt, Position pos, java.lang.Object... subst) Create a lexer that performs the substitutions in subst.
protected Node	parse(int kind, java.lang.String fmt, java.lang.Object... subst) Parse a string into an AST node of the given type, applying substitutions.
ClassDecl	parseDecl(java.lang.String fmt, java.util.List<?> subst) Parse a string into a ClassDecl AST node, applying substitutions.
ClassDecl	parseDecl(java.lang.String fmt, java.lang.Object... os) Parse a string into a ClassDecl AST node, applying substitutions.
Expr	parseExpr(java.lang.String fmt, java.util.List<?> subst) Parse a string into a Expr AST node, applying substitutions.
Expr	parseExpr(java.lang.String fmt, java.lang.Object... os) Parse a string into a Expr AST node, applying substitutions.
SourceFile	parseFile(java.lang.String fmt, java.util.List<?> subst) Parse a string into a SourceFile AST node, applying substitutions.
SourceFile	parseFile(java.lang.String fmt, java.lang.Object... os) Parse a string into a SourceFile AST node, applying substitutions.
ClassMember	parseMember(java.lang.String fmt, java.util.List<?> subst) Parse a string into a ClassMember AST node, applying substitutions.
ClassMember	parseMember(java.lang.String fmt, java.lang.Object... os) Parse a string into a ClassMember AST node, applying substitutions.
protected QQParser	parser(Lexer lexer, TypeSystem ts, NodeFactory nf, ErrorQueue eq) Create a quasiquoting parser.
Stmt	parseStmt(java.lang.String fmt, java.util.List<?> subst) Parse a string into a Stmt AST node, applying substitutions.
Stmt	parseStmt(java.lang.String fmt, java.lang.Object... os) Parse a string into a Stmt AST node, applying substitutions.
TypeNode	parseType(java.lang.String fmt, java.util.List<?> subst) Parse a string into a TypeNode AST node, applying substitutions.
TypeNode	parseType(java.lang.String fmt, java.lang.Object... os) Parse a string into a TypeNode AST node, applying substitutions.
protected Position	type_position(TypeObject t) Return a position for a type object.

Methods inherited from class java.lang.Object

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

Field Detail

ext

protected ExtensionInfo ext

pos

protected Position pos

EXPR

protected static final int EXPR

See Also:

Constant Field Values

STMT

protected static final int STMT

See Also:

Constant Field Values

TYPE

protected static final int TYPE

See Also:

Constant Field Values

MEMB

protected static final int MEMB

See Also:

Constant Field Values

DECL

protected static final int DECL

See Also:

Constant Field Values

FILE

protected static final int FILE

See Also:

Constant Field Values

Constructor Detail

QQ

public QQ(ExtensionInfo ext)

Create a new quasiquoter to create AST nodes of the given language extension.

QQ

public QQ(ExtensionInfo ext,
  Position pos)

Create a new quasiquoter to create AST nodes of the given language extension, using pos for the position of the nodes created.

Method Detail

parseFile

public SourceFile parseFile(java.lang.String fmt,
                   java.lang.Object... os)

Parse a string into a SourceFile AST node, applying substitutions.

parseFile

public SourceFile parseFile(java.lang.String fmt,
                   java.util.List<?> subst)

Parse a string into a SourceFile AST node, applying substitutions.

parseDecl

public ClassDecl parseDecl(java.lang.String fmt,
                  java.lang.Object... os)

Parse a string into a ClassDecl AST node, applying substitutions.

parseDecl

public ClassDecl parseDecl(java.lang.String fmt,
                  java.util.List<?> subst)

Parse a string into a ClassDecl AST node, applying substitutions.

parseMember

public ClassMember parseMember(java.lang.String fmt,
                      java.lang.Object... os)

Parse a string into a ClassMember AST node, applying substitutions.

parseMember

public ClassMember parseMember(java.lang.String fmt,
                      java.util.List<?> subst)

Parse a string into a ClassMember AST node, applying substitutions.

parseExpr

public Expr parseExpr(java.lang.String fmt,
             java.lang.Object... os)

Parse a string into a Expr AST node, applying substitutions.

parseExpr

public Expr parseExpr(java.lang.String fmt,
             java.util.List<?> subst)

Parse a string into a Expr AST node, applying substitutions.

parseStmt

public Stmt parseStmt(java.lang.String fmt,
             java.lang.Object... os)

Parse a string into a Stmt AST node, applying substitutions.

parseStmt

public Stmt parseStmt(java.lang.String fmt,
             java.util.List<?> subst)

Parse a string into a Stmt AST node, applying substitutions.

parseType

public TypeNode parseType(java.lang.String fmt,
                 java.lang.Object... os)

Parse a string into a TypeNode AST node, applying substitutions.

parseType

public TypeNode parseType(java.lang.String fmt,
                 java.util.List<?> subst)

Parse a string into a TypeNode AST node, applying substitutions.

lexer

protected Lexer lexer(java.lang.String fmt,
          Position pos,
          java.lang.Object... subst)

Create a lexer that performs the substitutions in subst.

parser

protected QQParser parser(Lexer lexer,
              TypeSystem ts,
              NodeFactory nf,
              ErrorQueue eq)

Create a quasiquoting parser.

type_position

protected Position type_position(TypeObject t)

Return a position for a type object. Generate one if the type doesn't have one.

parse

protected Node parse(int kind,
         java.lang.String fmt,
         java.lang.Object... subst)

Parse a string into an AST node of the given type, applying substitutions.