org.apache.flex.compiler.internal.as.codegen

Class Binding

java.lang.Object

org.apache.flex.compiler.internal.as.codegen.Binding

public class Binding
extends Object

A Binding collects information about a name that is relevant to the code generator:

• Semantic definition
• Local register access instructions -- cached here so they can be shared and assigned concrete registers at function wrapup.

Future enhancements:

• Cache more binding information for better codegen.
• Enforce const-ness of constant locals.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	Binding.SharedBindingInfo Data structure to hold information that can be shared between many bindings.

Constructor Summary

Constructors

Constructor and Description
Binding() Construct an empty Binding.
Binding(IASNode node, Binding other) Construct a Binding with the given node, but that otherwise has the same properties as the other binding passed in.
Binding(IASNode node, Name name, IDefinition def) Construct a Binding.

Method Summary

Methods

Modifier and Type	Method and Description
Instruction	declocal_i() Fetch this Binding's declocal_i instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.
Instruction	declocal() Fetch this Binding's declocal instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.
IDefinition	getDefinition()
Instruction	getlocal() Fetch this Binding's getlocal instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.
int	getLocalRegister()
Name	getName() Get the multiname for this binding - used to generate access by name
IASNode	getNode() Get the AST node that generated this binding, used for error reporting.
int	getSlotId() Get the Binding's slot id.
Instruction	inclocal_i() Fetch this Binding's inclocal_i instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.
Instruction	inclocal() Fetch this Binding's inclocal instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.
boolean	isLocal()
boolean	isSuperQualified() Was this Binding explicitly qualified with "super"?
Instruction	kill() Fetch this Binding's kill instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.
boolean	localNumberIsSet()
void	setIsLocal(boolean is_local) Flag this Binding as resident in a local register (or unset the flag).
Instruction	setlocal() Fetch this Binding's setlocal instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.
void	setSlotId(int slotId) Set the Binding's slot id.
void	setSuperQualified(boolean super_qualified) Indicate that this Binding had a "super" qualifier.
boolean	slotIdIsSet()
String	toString()

Methods inherited from class java.lang.Object

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

Constructor Detail

Binding

public Binding()

Construct an empty Binding. Used for Bindings that refer to internal constructs, e.g., this.

Binding

public Binding(IASNode node,
       Name name,
       IDefinition def)

Construct a Binding.

Parameters:

name - - the Binding's name.

def - - the Binding's definition, if known.

Binding

public Binding(IASNode node,
       Binding other)

Construct a Binding with the given node, but that otherwise has the same properties as the other binding passed in.

Parameters:

node - the node that generated this binding

other - the binding with the shared binding info to use

Method Detail

getName

public Name getName()

Get the multiname for this binding - used to generate access by name

Returns:

The name for the binding

getNode

public IASNode getNode()

Get the AST node that generated this binding, used for error reporting.

Returns:

the IASNode, or null if not present.

getDefinition

public IDefinition getDefinition()

isLocal

public boolean isLocal()

Returns:

true if this Binding has been flagged as resident in a local register.

setIsLocal

public void setIsLocal(boolean is_local)

Flag this Binding as resident in a local register (or unset the flag).

Parameters:

is_local - - the new value of the "binding lives in a register" flag.

localNumberIsSet

public boolean localNumberIsSet()

Returns:

true if this Binding's local number has already been set. Useful if a group of Bindings have subgroups that may get their local numbers set in distinct phases (e.g., the set of Bindings in registers has a subset of parameter Bindings that have preallocated register numbers).

getLocalRegister

public int getLocalRegister()

Returns:

this Binding's local register number.

getlocal

public Instruction getlocal()

Fetch this Binding's getlocal instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.

Returns:

the Binding's getlocal instruction. The instruction will be created if not already present.

setlocal

public Instruction setlocal()

Fetch this Binding's setlocal instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.

Returns:

the Binding's setlocal instruction. The instruction will be created if not already present.

inclocal

public Instruction inclocal()

Fetch this Binding's inclocal instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.

Returns:

the Binding's inclocal instruction. The instruction will be created if not already present.

inclocal_i

public Instruction inclocal_i()

Fetch this Binding's inclocal_i instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.

Returns:

the Binding's inclocal_i instruction. The instruction will be created if not already present.

declocal

public Instruction declocal()

Fetch this Binding's declocal instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.

Returns:

the Binding's declocal instruction. The instruction will be created if not already present.

declocal_i

public Instruction declocal_i()

Fetch this Binding's declocal_i instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.

Returns:

the Binding's declocal_i instruction. The instruction will be created if not already present.

getSlotId

public int getSlotId()

Get the Binding's slot id. If this is 0, it is an AVM assigned id.

Returns:

slot id.

slotIdIsSet

public boolean slotIdIsSet()

Returns:

true if this Binding's slot id number has been set, rather than relying on a runtime slot.

setSlotId

public void setSlotId(int slotId)

Set the Binding's slot id. If this is 0, it is an AVM assigned id.

kill

public Instruction kill()

Fetch this Binding's kill instruction; the Binding manages a single instruction so that its register number can be assigned at function wrap-up time.

Returns:

the Binding's kill instruction. The instruction will be created if not already present.

toString

public String toString()

Overrides:

toString in class Object

setSuperQualified

public void setSuperQualified(boolean super_qualified)

Indicate that this Binding had a "super" qualifier.

Parameters:

super_qualified - - set true if the name that generated this Binding had an explicit "super" qualifier.

isSuperQualified

public boolean isSuperQualified()

Was this Binding explicitly qualified with "super"?

Returns:

true if the name that generated this Binding had an explicit "super" qualifier.