polyglot.ast

Class Assign_c

java.lang.Object

polyglot.ast.Node_c

polyglot.ast.Term_c

polyglot.ast.Expr_c

polyglot.ast.Assign_c

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Assign, Expr, ExprOps, Node, NodeOps, Prefix, Receiver, Term, TermOps, Typed, Copy<Node>

Direct Known Subclasses:

AmbAssign_c, ArrayAccessAssign_c, FieldAssign_c, LocalAssign_c

public abstract class Assign_c
extends Expr_c
implements Assign

An Assign represents a Java assignment expression.

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from interface polyglot.ast.Assign

Assign.Operator

Nested classes/interfaces inherited from interface polyglot.util.Copy

Copy.Util

Nested classes/interfaces inherited from interface polyglot.ast.Term

Term.Instance

Field Summary

Fields

Modifier and Type	Field and Description
protected Expr	left
protected Assign.Operator	op
protected Expr	right

Fields inherited from class polyglot.ast.Expr_c

type

Fields inherited from class polyglot.ast.Term_c

exceptions, reachable

Fields inherited from class polyglot.ast.Node_c

del, error, ext, position

Fields inherited from interface polyglot.ast.Assign

ADD_ASSIGN, ASSIGN, BIT_AND_ASSIGN, BIT_OR_ASSIGN, BIT_XOR_ASSIGN, DIV_ASSIGN, MOD_ASSIGN, MUL_ASSIGN, SHL_ASSIGN, SHR_ASSIGN, SUB_ASSIGN, USHR_ASSIGN

Fields inherited from interface polyglot.ast.Term

ENTRY, EXIT

Constructor Summary

Constructors

Constructor and Description
Assign_c(Position pos, Expr left, Assign.Operator op, Expr right) Deprecated.
Assign_c(Position pos, Expr left, Assign.Operator op, Expr right, Ext ext)

Method Summary

Methods

Modifier and Type	Method and Description
<T> java.util.List<T>	acceptCFG(CFGBuilder<?> v, java.util.List<T> succs) Visit this term in evaluation order, calling v.edge() for each successor in succs, if data flows on that edge.
protected abstract void	acceptCFGAssign(CFGBuilder<?> v) Construct a CFG for this assignment when the assignment operator is ASSIGN (i.e., the normal, simple assignment =).
protected abstract void	acceptCFGOpAssign(CFGBuilder<?> v) Construct a CFG for this assignment when the assignment operator is of the form op= for some operation op.
Type	childExpectedType(Expr child, AscriptionVisitor av) Get the expected type of a child expression of this.
Node	copy(NodeFactory nf) Produce a copy of this node using the given NodeFactory.
void	dump(CodeWriter w) Dump the AST node for debugging purposes.
abstract Term	firstChild() Return the first direct subterm performed when evaluating this term.
Expr	left() Left child (target) of the assignment.
Assign	left(Expr left) Set the left child (target) of the assignment.
protected <N extends Assign_c> N	left(N n, Expr left)
Assign.Operator	operator() The assignment's operator.
Assign	operator(Assign.Operator op) Set the assignment's operator.
protected <N extends Assign_c> N	operator(N n, Assign.Operator op)
Precedence	precedence() Get the precedence of the expression.
void	prettyPrint(CodeWriter w, PrettyPrinter tr) Pretty-print the AST using the given CodeWriter.
protected <N extends Assign_c> N	reconstruct(N n, Expr left, Expr right) Reconstruct the expression.
Expr	right() Right child (source) of the assignment.
Assign	right(Expr right) Set the right child (source) of the assignment.
protected <N extends Assign_c> N	right(N n, Expr right)
boolean	throwsArithmeticException() Get the throwsArithmeticException of the expression.
java.util.List<Type>	throwTypes(TypeSystem ts) List of Types of exceptions that might get thrown.
java.lang.String	toString()
Node	typeCheck(TypeChecker tc) Type check the AST.
Node	visitChildren(NodeVisitor v) Visit the children of the node.

Methods inherited from class polyglot.ast.Expr_c

booleanValue, buildTypes, byteValue, charValue, constantValue, constantValue, constantValueSet, constantValueSet, doubleValue, extRewrite, floatValue, intValue, isConstant, isConstant, isTypeChecked, lastLang, longValue, printSubExpr, printSubExpr, shortValue, stringValue, type, type, type

Methods inherited from class polyglot.ast.Term_c

exceptionCheck, exceptions, exceptions, exceptions, listChild, reachable, reachable, reachable

Methods inherited from class polyglot.ast.Node_c

addDecls, buildTypesEnter, checkConstants, copy, copy, copyIfNeeded, del, del, disambiguate, disambiguateEnter, disambiguateOverride, dump, dump, dump, dump, enterChildScope, enterScope, error, error, error, exceptionCheckEnter, ext, ext, ext, ext, extRewriteEnter, isDisambiguated, lang, position, position, position, prettyPrint, prettyPrint, prettyPrint, prettyPrint, print, printBlock, printSubStmt, translate, typeCheckEnter, typeCheckOverride, visit, visitChild, visitEdge, visitList

Methods inherited from class java.lang.Object

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

Methods inherited from interface polyglot.ast.Expr

constantValue, constantValueSet, isConstant, printSubExpr, printSubExpr, type

Methods inherited from interface polyglot.ast.Node

del, del, error, error, ext, ext, ext, ext, isDisambiguated, isTypeChecked, position, position, visit, visitEdge

Methods inherited from interface polyglot.ast.NodeOps

addDecls, buildTypes, buildTypesEnter, checkConstants, copy, disambiguate, disambiguateEnter, disambiguateOverride, dump, dump, dump, dump, enterChildScope, enterScope, exceptionCheck, exceptionCheckEnter, extRewrite, extRewriteEnter, lang, prettyPrint, prettyPrint, prettyPrint, prettyPrint, translate, typeCheckEnter, typeCheckOverride, visitChild, visitList

Methods inherited from interface polyglot.util.Copy

copy

Methods inherited from interface polyglot.ast.Typed

type

Methods inherited from interface polyglot.ast.Term

exceptions, exceptions, reachable, reachable

Field Detail

left

protected Expr left

op

protected Assign.Operator op

right

protected Expr right

Constructor Detail

Assign_c

@Deprecated
public Assign_c(Position pos,
                   Expr left,
                   Assign.Operator op,
                   Expr right)

Deprecated.

Assign_c

public Assign_c(Position pos,
        Expr left,
        Assign.Operator op,
        Expr right,
        Ext ext)

Method Detail

precedence

public Precedence precedence()

Description copied from interface: Expr

Get the precedence of the expression.

Specified by:

precedence in interface Expr

Overrides:

precedence in class Expr_c

left

public Expr left()

Description copied from interface: Assign

Left child (target) of the assignment. The target must be a Variable, but this is not enforced statically to keep Polyglot backward compatible.

Specified by:

left in interface Assign

left

public Assign left(Expr left)

Description copied from interface: Assign

Set the left child (target) of the assignment. The target must be a Variable, but this is not enforced statically to keep Polyglot backward compatible.

Specified by:

left in interface Assign

left

protected <N extends Assign_c> N left(N n,
                          Expr left)

operator

public Assign.Operator operator()

Description copied from interface: Assign

The assignment's operator.

Specified by:

operator in interface Assign

operator

public Assign operator(Assign.Operator op)

Description copied from interface: Assign

Set the assignment's operator.

Specified by:

operator in interface Assign

operator

protected <N extends Assign_c> N operator(N n,
                              Assign.Operator op)

right

public Expr right()

Description copied from interface: Assign

Right child (source) of the assignment.

Specified by:

right in interface Assign

right

public Assign right(Expr right)

Description copied from interface: Assign

Set the right child (source) of the assignment.

Specified by:

right in interface Assign

right

protected <N extends Assign_c> N right(N n,
                           Expr right)

reconstruct

protected <N extends Assign_c> N reconstruct(N n,
                                 Expr left,
                                 Expr right)

Reconstruct the expression.

visitChildren

public Node visitChildren(NodeVisitor v)

Description copied from interface: NodeOps

Visit the children of the node.

Specified by:

visitChildren in interface NodeOps

Overrides:

visitChildren in class Node_c

Parameters:

v - The visitor that will traverse/rewrite the AST.

Returns:

A new AST if a change was made, or this.

typeCheck

public Node typeCheck(TypeChecker tc)
               throws SemanticException

Description copied from interface: NodeOps

Type check the AST. 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.

Specified by:

typeCheck in interface NodeOps

Overrides:

typeCheck in class Node_c

Parameters:

tc - The type checking visitor.

Throws:

SemanticException

childExpectedType

public Type childExpectedType(Expr child,
                     AscriptionVisitor av)

Description copied from interface: NodeOps

Get the expected type of a child expression of 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.

Specified by:

childExpectedType in interface NodeOps

Overrides:

childExpectedType in class Node_c

Parameters:

child - A child expression of this node.

av - An ascription visitor.

Returns:

The expected type of child.

throwsArithmeticException

public boolean throwsArithmeticException()

Description copied from interface: Assign

Get the throwsArithmeticException of the expression.

Specified by:

throwsArithmeticException in interface Assign

toString

public java.lang.String toString()

Overrides:

toString in class Node_c

prettyPrint

public void prettyPrint(CodeWriter w,
               PrettyPrinter tr)

Description copied from class: Node_c

Pretty-print the AST using the given CodeWriter.

Specified by:

prettyPrint in interface NodeOps

Overrides:

prettyPrint in class Node_c

Parameters:

w - The code writer to which to write.

tr - The pretty printer. This is not a visitor.

dump

public void dump(CodeWriter w)

Description copied from interface: Node

Dump the AST node for debugging purposes.

Specified by:

dump in interface Node

Overrides:

dump in class Expr_c

firstChild

public abstract Term firstChild()

Description copied from interface: TermOps

Return the first direct subterm performed when evaluating this term. If this term has no subterms, this should return null. This method is similar to the deprecated entry(), but it should *not* recursively drill down to the innermost subterm. The direct child visited first in this term's dataflow should be returned.

Specified by:

firstChild in interface TermOps

Specified by:

firstChild in class Term_c

acceptCFG

public <T> java.util.List<T> acceptCFG(CFGBuilder<?> v,
                              java.util.List<T> succs)

Description copied from interface: TermOps

Visit this term in evaluation order, calling v.edge() for each successor in succs, if data flows on that edge.

Specified by:

acceptCFG in interface TermOps

Specified by:

acceptCFG in class Term_c

acceptCFGAssign

protected abstract void acceptCFGAssign(CFGBuilder<?> v)

Construct a CFG for this assignment when the assignment operator is ASSIGN (i.e., the normal, simple assignment =).

acceptCFGOpAssign

protected abstract void acceptCFGOpAssign(CFGBuilder<?> v)

Construct a CFG for this assignment when the assignment operator is of the form op= for some operation op.

throwTypes

public java.util.List<Type> throwTypes(TypeSystem ts)

Description copied from interface: NodeOps

List of Types of exceptions that might get thrown. The result is not necessarily correct until after type checking.

Specified by:

throwTypes in interface NodeOps

Overrides:

throwTypes in class Node_c

copy

public Node copy(NodeFactory nf)

Description copied from interface: NodeOps

Produce a copy of this node using the given NodeFactory.

Specified by:

copy in interface NodeOps

Overrides:

copy in class Node_c