public abstract class Ext_c extends java.lang.Object implements Ext
Ext
is the super type of all node extension objects.
It contains a pointer back to the node it is extending and a possibly-null
pointer to another extension node.Modifier and Type | Field and Description |
---|---|
protected Ext |
ext |
protected Node |
node |
protected NodeOps |
pred |
Modifier and Type | Method and Description |
---|---|
void |
addDecls(Context c)
Add any declarations to the context that should be in scope when
visiting later sibling nodes.
|
Node |
buildTypes(TypeBuilder tb)
Collects classes, methods, and fields from the AST rooted at this node
and constructs type objects for these.
|
NodeVisitor |
buildTypesEnter(TypeBuilder tb)
Collects classes, methods, and fields from the AST rooted at this node
and constructs type objects for these.
|
Node |
checkConstants(ConstantChecker cc)
Check if the node is a compile-time constant.
|
Type |
childExpectedType(Expr child,
AscriptionVisitor av)
Get the expected type of a child expression of
this . |
Ext |
copy() |
Node |
copy(ExtensionInfo extInfo)
Produce a copy of this node using the given ExtensionInfo.
|
Node |
copy(NodeFactory nf)
Produce a copy of this node using the given NodeFactory.
|
Node |
disambiguate(AmbiguityRemover ar)
Remove any remaining ambiguities from the AST.
|
NodeVisitor |
disambiguateEnter(AmbiguityRemover ar)
Remove any remaining ambiguities from the AST.
|
Node |
disambiguateOverride(Node parent,
AmbiguityRemover ar)
Disambiguate the AST.
|
void |
dump(CodeWriter w)
Dump the AST node for debugging purposes.
|
void |
dump(Lang lang,
java.io.OutputStream os)
Dump the AST for debugging.
|
void |
dump(Lang lang,
java.io.Writer w)
Dump the AST for debugging.
|
void |
dump(java.io.OutputStream os)
Deprecated.
|
void |
dump(java.io.Writer w)
Deprecated.
|
Context |
enterChildScope(Node child,
Context c)
Push a new scope for visiting the child node
child . |
Context |
enterScope(Context c)
Push a new scope upon entering this node, and add any declarations to the
context that should be in scope when visiting children of this node.
|
Node |
exceptionCheck(ExceptionChecker ec)
Check that exceptions are properly propagated throughout the AST.
|
NodeVisitor |
exceptionCheckEnter(ExceptionChecker ec)
Check that exceptions are properly propagated throughout the AST.
|
Ext |
ext()
An extension of this extension, or null.
|
Ext |
ext(Ext ext)
Set the extension of this extension.
|
Node |
extRewrite(ExtensionRewriter rw)
Rewrite the AST for the compilation in this language.
|
NodeVisitor |
extRewriteEnter(ExtensionRewriter rw)
Rewrite the AST for the compilation in this language.
|
void |
init(Node node)
Initialize the extension object's pointer back to the node.
|
void |
initPred(NodeOps pred)
Initialize the extension object's pointer back to the parent.
|
Lang |
lang()
The language defined by this NodeOps implementation.
|
Node |
node()
The node we ultimately extend.
|
NodeOps |
pred()
The parent of this extension.
|
void |
prettyPrint(CodeWriter w,
PrettyPrinter pp)
Pretty-print the AST using the given
CodeWriter . |
void |
prettyPrint(Lang lang,
java.io.OutputStream os)
Pretty-print the AST for debugging.
|
void |
prettyPrint(Lang lang,
java.io.Writer w)
Pretty-print the AST for debugging.
|
void |
prettyPrint(java.io.OutputStream os)
Deprecated.
|
void |
prettyPrint(java.io.Writer w)
Deprecated.
|
void |
print(Node child,
CodeWriter w,
PrettyPrinter pp) |
void |
printBlock(Node n,
CodeWriter w,
PrettyPrinter pp) |
void |
printSubStmt(Stmt stmt,
CodeWriter w,
PrettyPrinter pp) |
protected JLang |
superLang() |
java.util.List<Type> |
throwTypes(TypeSystem ts)
List of Types of exceptions that might get thrown.
|
java.lang.String |
toString() |
void |
translate(CodeWriter w,
Translator tr)
Translate the AST using the given
CodeWriter . |
Node |
typeCheck(TypeChecker tc)
Type check the AST.
|
NodeVisitor |
typeCheckEnter(TypeChecker tc)
Type check the AST.
|
Node |
typeCheckOverride(Node parent,
TypeChecker tc)
Type check the AST.
|
<N extends Node> |
visitChild(N child,
NodeVisitor v)
Visit a single child of the node.
|
Node |
visitChildren(NodeVisitor v)
Visit the children of the node.
|
<N extends Node> |
visitList(java.util.List<N> l,
NodeVisitor v)
Visit all the elements of a list.
|
public Ext_c()
public Ext_c(Ext ext)
public Lang lang()
NodeOps
protected final JLang superLang()
public <N extends Node> N visitChild(N child, NodeVisitor v)
NodeOps
visitChild
in interface NodeOps
child
- The child to visit.v
- The visitor which will traverse/rewrite the AST.child.visit(v)
, or null
if child
was null
.public <N extends Node> java.util.List<N> visitList(java.util.List<N> l, NodeVisitor v)
NodeOps
public void init(Node node)
Ext
public void initPred(NodeOps pred)
Ext
public Ext ext()
Ext
public Ext ext(Ext ext)
Ext
public java.lang.String toString()
toString
in class java.lang.Object
public void dump(CodeWriter w)
Ext
public Node visitChildren(NodeVisitor v)
NodeOps
visitChildren
in interface NodeOps
v
- The visitor that will traverse/rewrite the AST.this
.public Context enterScope(Context c)
NodeOps
addDecls
when leaving the node
for that.enterScope
in interface NodeOps
c
- the current Context
Context
to be used for visiting this node.public Context enterChildScope(Node child, Context c)
NodeOps
child
.
The default behavior is to delegate the call to the child node, and let
it add appropriate declarations that should be in scope. However,
this method gives parent nodes have the ability to modify this behavior.enterChildScope
in interface NodeOps
child
- the child node about to be entered.c
- the current Context
Context
to be used for visiting node
child
public void addDecls(Context c)
NodeOps
public NodeVisitor buildTypesEnter(TypeBuilder tb) throws SemanticException
NodeOps
TypeSystem
.
This method is called by the enter()
method of the
visitor. The * method should perform work that should be done
before visiting the children of the node. The method may return
this
or a new copy of the node on which
visitChildren()
and leave()
will be
invoked.buildTypesEnter
in interface NodeOps
tb
- The visitor which adds new type objects to the
TypeSystem
.SemanticException
public Node buildTypes(TypeBuilder tb) throws SemanticException
NodeOps
TypeSystem
.
This method is called by the leave()
method of the
visitor. The method should perform work that should be done
after visiting the children of the node. The method may return
this
or a new copy of the node which will be
installed as a child of the node's parent.buildTypes
in interface NodeOps
tb
- The visitor which adds new type objects to the
TypeSystem
.SemanticException
public Node disambiguateOverride(Node parent, AmbiguityRemover ar) throws SemanticException
NodeOps
override()
method of the
visitor. If this method returns non-null, the node's children
will not be visited automatically. Thus, the method should check
both the node this
and it's children, usually by
invoking visitChildren
with tc
or
with another visitor, returning a non-null node. OR, the method
should do nothing and simply return null
to allow
enter
, visitChildren
, and leave
to be invoked on the node.
The default implementation returns null
.
Overriding of this method is discouraged, but sometimes necessary.disambiguateOverride
in interface NodeOps
ar
- The visitor which disambiguates.SemanticException
public NodeVisitor disambiguateEnter(AmbiguityRemover ar) throws SemanticException
NodeOps
enter()
method of the
visitor. The * method should perform work that should be done
before visiting the children of the node. The method may return
this
or a new copy of the node on which
visitChildren()
and leave()
will be
invoked.disambiguateEnter
in interface NodeOps
ar
- The visitor which disambiguates.SemanticException
public Node disambiguate(AmbiguityRemover ar) throws SemanticException
NodeOps
leave()
method of the
visitor. The method should perform work that should be done
after visiting the children of the node. The method may return
this
or a new copy of the node which will be
installed as a child of the node's parent.
The node should not assume that its children have been disambiguated.
If it depends on a child being disambiguated,
it may just return this
without doing any work.disambiguate
in interface NodeOps
ar
- The visitor which disambiguates.SemanticException
public Node typeCheckOverride(Node parent, TypeChecker tc) throws SemanticException
NodeOps
override()
method of the
visitor. If this method returns non-null, the node's children
will not be visited automatically. Thus, the method should check
both the node this
and it's children, usually by
invoking visitChildren
with tc
or
with another visitor, returning a non-null node. OR, the method
should do nothing and simply return null
to allow
enter
, visitChildren
, and leave
to be invoked on the node.
The default implementation returns null
.
Overriding of this method is discouraged, but sometimes necessary.typeCheckOverride
in interface NodeOps
tc
- The type checking visitor.SemanticException
public NodeVisitor typeCheckEnter(TypeChecker tc) throws SemanticException
NodeOps
enter()
method of the
visitor. The * method should perform work that should be done
before visiting the children of the node. The method may return
this
or a new copy of the node on which
visitChildren()
and leave()
will be
invoked.typeCheckEnter
in interface NodeOps
tc
- The type checking visitor.SemanticException
public Node typeCheck(TypeChecker tc) throws SemanticException
NodeOps
leave()
method of the
visitor. The method should perform work that should be done
after visiting the children of the node. The method may return
this
or a new copy of the node which will be
installed as a child of the node's parent.typeCheck
in interface NodeOps
tc
- The type checking visitor.SemanticException
public Type childExpectedType(Expr child, AscriptionVisitor av)
NodeOps
this
.
The expected type is determined by the context in that the child occurs
(e.g., for x = e
, the expected type of e
is
the declared type of x
.
The expected type should impose the least constraints on the child's
type that are allowed by the parent node.childExpectedType
in interface NodeOps
child
- A child expression of this node.av
- An ascription visitor.child
.public Node checkConstants(ConstantChecker cc) throws SemanticException
NodeOps
leave()
method of the
visitor. The method should perform work that should be done
after visiting the children of the node. The method may return
this
or a new copy of the node which will be
installed as a child of the node's parent.checkConstants
in interface NodeOps
cc
- The constant checking visitor.SemanticException
public NodeVisitor exceptionCheckEnter(ExceptionChecker ec) throws SemanticException
NodeOps
enter()
method of the
visitor. The * method should perform work that should be done
before visiting the children of the node. The method may return
this
or a new copy of the node on which
visitChildren()
and leave()
will be
invoked.exceptionCheckEnter
in interface NodeOps
ec
- The visitor.SemanticException
public Node exceptionCheck(ExceptionChecker ec) throws SemanticException
NodeOps
leave()
method of the
visitor. The method should perform work that should be done
after visiting the children of the node. The method may return
this
or a new copy of the node which will be
installed as a child of the node's parent.exceptionCheck
in interface NodeOps
ec
- The visitor.SemanticException
public java.util.List<Type> throwTypes(TypeSystem ts)
NodeOps
throwTypes
in interface NodeOps
public NodeVisitor extRewriteEnter(ExtensionRewriter rw) throws SemanticException
NodeOps
enter()
method of the
visitor. The method should perform work that should be done
before visiting the children of the node. The method may return
this
or a new copy of the node on which
visitChildren()
and leave()
will be
invoked.extRewriteEnter
in interface NodeOps
rw
- The visitor.SemanticException
public Node extRewrite(ExtensionRewriter rw) throws SemanticException
NodeOps
leave()
method of the
visitor. The method should perform work that should be done
after visiting the children of the node. The method may return
this
or a new copy of the node which will be
installed as a child of the node's parent.extRewrite
in interface NodeOps
rw
- The visitor.SemanticException
@Deprecated public void dump(java.io.OutputStream os)
NodeOps
public void dump(Lang lang, java.io.OutputStream os)
NodeOps
@Deprecated public void dump(java.io.Writer w)
NodeOps
public void dump(Lang lang, java.io.Writer w)
NodeOps
@Deprecated public void prettyPrint(java.io.OutputStream os)
NodeOps
prettyPrint
in interface NodeOps
public void prettyPrint(Lang lang, java.io.OutputStream os)
NodeOps
prettyPrint
in interface NodeOps
@Deprecated public void prettyPrint(java.io.Writer w)
NodeOps
prettyPrint
in interface NodeOps
public void prettyPrint(Lang lang, java.io.Writer w)
NodeOps
prettyPrint
in interface NodeOps
public void prettyPrint(CodeWriter w, PrettyPrinter pp)
NodeOps
CodeWriter
.prettyPrint
in interface NodeOps
w
- The code writer to which to write.pp
- The pretty printer. This is not a visitor.public void print(Node child, CodeWriter w, PrettyPrinter pp)
public void printBlock(Node n, CodeWriter w, PrettyPrinter pp)
public void printSubStmt(Stmt stmt, CodeWriter w, PrettyPrinter pp)
public void translate(CodeWriter w, Translator tr)
NodeOps
CodeWriter
.public Node copy(NodeFactory nf)
NodeOps
public Node copy(ExtensionInfo extInfo) throws SemanticException
NodeOps
copy
in interface NodeOps
SemanticException
- If the type information cannot be copied.