polyglot.ast

Class Call_c

java.lang.Object

polyglot.ast.Node_c

polyglot.ast.Term_c

polyglot.ast.Expr_c

polyglot.ast.Call_c

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, Call, CallOps, Expr, ExprOps, Node, NodeOps, Prefix, ProcedureCall, ProcedureCallOps, Receiver, Term, TermOps, Typed, Copy<Node>

public class Call_c
extends Expr_c
implements Call, CallOps

A Call is an immutable representation of a Java method call. It consists of a method name and a list of arguments. It may also have either a Type upon which the method is being called or an expression upon which the method is being called.

See Also:

Serialized Form

Nested Class Summary

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 java.util.List<Expr>	arguments
protected MethodInstance	mi
protected Id	name
protected Receiver	target
protected boolean	targetImplicit

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.Term

ENTRY, EXIT

Constructor Summary

Constructors

Constructor and Description
Call_c(Position pos, Receiver target, Id name, java.util.List<Expr> arguments)
Call_c(Position pos, Receiver target, Id name, java.util.List<Expr> arguments, 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.
java.util.List<Expr>	arguments() The call's actual arguments.
ProcedureCall	arguments(java.util.List<Expr> arguments) Set the call's actual arguments.
protected <N extends Call_c> N	arguments(N n, java.util.List<Expr> arguments)
Node	buildTypes(TypeBuilder tb) Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these.
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.
Node	exceptionCheck(ExceptionChecker ec) Check that exceptions are properly propagated throughout the AST.
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.
Type	findContainer(TypeSystem ts, MethodInstance mi) Used to find the missing static target of a static method call.
ReferenceType	findTargetType()
Term	firstChild() Return the first direct subterm performed when evaluating this term.
Id	id() The name of the method to call.
Call	id(Id name) Set the name of the method to call.
protected <N extends Call_c> N	id(N n, Id name)
boolean	isTargetImplicit() Indicates if the target of this call is implicit, that is, was not specified explicitly in the syntax.
MethodInstance	methodInstance() The method instance of the method to call.
Call	methodInstance(MethodInstance mi) Set the method instance of the method to call.
protected <N extends Call_c> N	methodInstance(N n, MethodInstance mi)
java.lang.String	name() The name of the method to call.
Call	name(java.lang.String name) Set the name of the method to call.
Precedence	precedence() Get the precedence of the expression.
void	prettyPrint(CodeWriter w, PrettyPrinter tr) Pretty-print the AST using the given CodeWriter.
void	printArgs(CodeWriter w, PrettyPrinter tr)
ProcedureInstance	procedureInstance() The type object of the procedure we are calling.
protected <N extends Call_c> N	reconstruct(N n, Receiver target, Id name, java.util.List<Expr> arguments) Reconstruct the call.
Receiver	target() The call's target object or type.
protected <N extends Call_c> N	target(N n, Receiver target)
Call	target(Receiver target) Set the call's target or type.
Call	targetImplicit(boolean targetImplicit) Set whether the target of this call is implicit.
protected <N extends Call_c> N	targetImplicit(N n, boolean targetImplicit)
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	typeCheckNullTarget(TypeChecker tc, java.util.List<Type> argTypes) Typecheck the Call when the target is null.
Node	visitChildren(NodeVisitor v) Visit the children of the node.

Methods inherited from class polyglot.ast.Expr_c

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

Methods inherited from class polyglot.ast.Term_c

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, 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, buildTypesEnter, checkConstants, copy, disambiguate, disambiguateEnter, disambiguateOverride, dump, dump, dump, dump, enterChildScope, enterScope, exceptionCheckEnter, 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

Methods inherited from interface polyglot.ast.ExprOps

constantValue, constantValueSet, isConstant

Field Detail

target

protected Receiver target

name

protected Id name

arguments

protected java.util.List<Expr> arguments

mi

protected MethodInstance mi

targetImplicit

protected boolean targetImplicit

Constructor Detail

Call_c

public Call_c(Position pos,
      Receiver target,
      Id name,
      java.util.List<Expr> arguments)

Call_c

public Call_c(Position pos,
      Receiver target,
      Id name,
      java.util.List<Expr> arguments,
      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

target

public Receiver target()

Description copied from interface: Call

The call's target object or type.

Specified by:

target in interface Call

target

public Call target(Receiver target)

Description copied from interface: Call

Set the call's target or type.

Specified by:

target in interface Call

target

protected <N extends Call_c> N target(N n,
                          Receiver target)

id

public Id id()

Description copied from interface: Call

The name of the method to call.

Specified by:

id in interface Call

id

public Call id(Id name)

Description copied from interface: Call

Set the name of the method to call.

Specified by:

id in interface Call

id

protected <N extends Call_c> N id(N n,
                      Id name)

name

public java.lang.String name()

Description copied from interface: Call

The name of the method to call.

Specified by:

name in interface Call

name

public Call name(java.lang.String name)

Description copied from interface: Call

Set the name of the method to call.

Specified by:

name in interface Call

procedureInstance

public ProcedureInstance procedureInstance()

Description copied from interface: ProcedureCall

The type object of the procedure we are calling. This is, generally, only valid after the type-checking pass.

Specified by:

procedureInstance in interface ProcedureCall

methodInstance

public MethodInstance methodInstance()

Description copied from interface: Call

The method instance of the method to call. This is, generally, only valid after the type-checking pass.

Specified by:

methodInstance in interface Call

methodInstance

public Call methodInstance(MethodInstance mi)

Description copied from interface: Call

Set the method instance of the method to call.

Specified by:

methodInstance in interface Call

methodInstance

protected <N extends Call_c> N methodInstance(N n,
                                  MethodInstance mi)

isTargetImplicit

public boolean isTargetImplicit()

Description copied from interface: Call

Indicates if the target of this call is implicit, that is, was not specified explicitly in the syntax.

Specified by:

isTargetImplicit in interface Call

Returns:

boolean indicating if the target of this call is implicit

targetImplicit

public Call targetImplicit(boolean targetImplicit)

Description copied from interface: Call

Set whether the target of this call is implicit.

Specified by:

targetImplicit in interface Call

targetImplicit

protected <N extends Call_c> N targetImplicit(N n,
                                  boolean targetImplicit)

arguments

public java.util.List<Expr> arguments()

Description copied from interface: ProcedureCall

The call's actual arguments.

Specified by:

arguments in interface ProcedureCall

Returns:

A list of Expr.

arguments

public ProcedureCall arguments(java.util.List<Expr> arguments)

Description copied from interface: ProcedureCall

Set the call's actual arguments.

Specified by:

arguments in interface ProcedureCall

Parameters:

arguments - A list of Expr.

arguments

protected <N extends Call_c> N arguments(N n,
                             java.util.List<Expr> arguments)

reconstruct

protected <N extends Call_c> N reconstruct(N n,
                               Receiver target,
                               Id name,
                               java.util.List<Expr> arguments)

Reconstruct the call.

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.

buildTypes

public Node buildTypes(TypeBuilder tb)
                throws SemanticException

Description copied from interface: NodeOps

Collects classes, methods, and fields from the AST rooted at this node and constructs type objects for these. These type objects may be ambiguous. Inserts classes into the 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.

Specified by:

buildTypes in interface NodeOps

Overrides:

buildTypes in class Expr_c

Parameters:

tb - The visitor which adds new type objects to the TypeSystem.

Throws:

SemanticException

typeCheckNullTarget

public Node typeCheckNullTarget(TypeChecker tc,
                       java.util.List<Type> argTypes)
                         throws SemanticException

Description copied from interface: CallOps

Typecheck the Call when the target is null. This method finds an appropriate target, and then type checks accordingly.

Specified by:

typeCheckNullTarget in interface CallOps

argTypes - list of Types of the arguments

Throws:

SemanticException

findContainer

public Type findContainer(TypeSystem ts,
                 MethodInstance mi)

Description copied from interface: CallOps

Used to find the missing static target of a static method call. Should return the container of the method instance.

Specified by:

findContainer in interface CallOps

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

findTargetType

public ReferenceType findTargetType()
                             throws SemanticException

Specified by:

findTargetType in interface CallOps

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.

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.

printArgs

public void printArgs(CodeWriter w,
             PrettyPrinter tr)

Specified by:

printArgs in interface ProcedureCallOps

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 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

exceptionCheck

public Node exceptionCheck(ExceptionChecker ec)
                    throws SemanticException

Description copied from interface: NodeOps

Check that exceptions are properly propagated throughout 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:

exceptionCheck in interface NodeOps

Overrides:

exceptionCheck in class Term_c

Parameters:

ec - The visitor.

Throws:

SemanticException

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

extRewriteEnter

public NodeVisitor extRewriteEnter(ExtensionRewriter rw)
                            throws SemanticException

Description copied from interface: NodeOps

Rewrite the AST for the compilation in this language. 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.

Specified by:

extRewriteEnter in interface NodeOps

Overrides:

extRewriteEnter in class Node_c

Parameters:

rw - The visitor.

Throws:

SemanticException

extRewrite

public Node extRewrite(ExtensionRewriter rw)
                throws SemanticException

Description copied from interface: NodeOps

Rewrite the AST for the compilation in this language. 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:

extRewrite in interface NodeOps

Overrides:

extRewrite in class Expr_c

Parameters:

rw - The visitor.

Throws:

SemanticException

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