org.apache.flex.compiler.tree.as

Interface IExpressionNode

All Superinterfaces:

IASNode, ISourceLocation

All Known Subinterfaces:

IBinaryOperatorNode, IDynamicAccessNode, IEmbedNode, IFunctionCallNode, IFunctionObjectNode, IIdentifierNode, ILiteralContainerNode, ILiteralNode, IMemberAccessExpressionNode, INamespaceAccessExpressionNode, INamespaceDecorationNode, IOperatorNode, IRegExpLiteralNode, IReturnNode, ITernaryOperatorNode, IThrowNode, ITypedExpressionNode, IUnaryOperatorNode, IVariableExpressionNode

All Known Implementing Classes:

ArrayLiteralNode, BaseLiteralContainerNode, BaseStatementExpressionNode, BinaryOperatorAsNode, BinaryOperatorAssignmentNode, BinaryOperatorBitwiseAndAssignmentNode, BinaryOperatorBitwiseAndNode, BinaryOperatorBitwiseLeftShiftAssignmentNode, BinaryOperatorBitwiseLeftShiftNode, BinaryOperatorBitwiseOrAssignmentNode, BinaryOperatorBitwiseOrNode, BinaryOperatorBitwiseRightShiftAssignmentNode, BinaryOperatorBitwiseRightShiftNode, BinaryOperatorBitwiseUnsignedRightShiftAssignmentNode, BinaryOperatorBitwiseUnsignedRightShiftNode, BinaryOperatorBitwiseXorAssignmentNode, BinaryOperatorBitwiseXorNode, BinaryOperatorCommaNode, BinaryOperatorDivisionAssignmentNode, BinaryOperatorDivisionNode, BinaryOperatorEqualNode, BinaryOperatorGreaterThanEqualsNode, BinaryOperatorGreaterThanNode, BinaryOperatorInNode, BinaryOperatorInstanceOfNode, BinaryOperatorIsNode, BinaryOperatorLessThanEqualsNode, BinaryOperatorLessThanNode, BinaryOperatorLogicalAndAssignmentNode, BinaryOperatorLogicalAndNode, BinaryOperatorLogicalOrAssignmentNode, BinaryOperatorLogicalOrNode, BinaryOperatorMinusAssignmentNode, BinaryOperatorMinusNode, BinaryOperatorModuloAssignmentNode, BinaryOperatorModuloNode, BinaryOperatorMultiplicationAssignmentNode, BinaryOperatorMultiplicationNode, BinaryOperatorNodeBase, BinaryOperatorNotEqualNode, BinaryOperatorPlusAssignmentNode, BinaryOperatorPlusNode, BinaryOperatorStrictEqualNode, BinaryOperatorStrictNotEqualNode, ClassReferenceNode, ConfigExpressionNode, DynamicAccessNode, EmbedNode, ExpressionNodeBase, FoldedExpressionNode, FullNameNode, FunctionCallNode, FunctionObjectNode, IdentifierNode, InstructionListNode, LanguageIdentifierNode, LiteralNode, MemberAccessExpressionNode, NamespaceAccessExpressionNode, NamespaceIdentifierNode, NilNode, NonResolvingIdentifierNode, NumericLiteralNode, ObjectLiteralNode, ObjectLiteralValuePairNode, OperatorNodeBase, QualifiedNameExpressionNode, QualifiedNamespaceExpressionNode, RegExpLiteralNode, ReturnNode, RuntimeNameExpressionNode, TernaryOperatorNode, ThrowNode, TypedExpressionNode, UnaryOperatorAtNode, UnaryOperatorBitwiseNotNode, UnaryOperatorDeleteNode, UnaryOperatorLogicalNotNode, UnaryOperatorMinusNode, UnaryOperatorNodeBase, UnaryOperatorPlusNode, UnaryOperatorPostDecrementNode, UnaryOperatorPostfixNodeBase, UnaryOperatorPostIncrementNode, UnaryOperatorPreDecrementNode, UnaryOperatorPreIncrementNode, UnaryOperatorTypeOfNode, UnaryOperatorVoidNode, VariableExpressionNode, VectorLiteralNode, XMLListLiteralNode, XMLLiteralNode

public interface IExpressionNode
extends IASNode

An AST node representing any kind of expression.

Expressions include literal values, identifiers, and operator expressions. See ILiteralNode, IIdentifierNode, and IOperatorNode.

Field Summary

Fields inherited from interface org.apache.flex.compiler.common.ISourceLocation

UNKNOWN

Method Summary

Methods

Modifier and Type	Method and Description
IExpressionNode	copyForInitializer(IScopedNode scopeNode) Return a copy of this IExpressionNode and all it's children that can be used by VariableDefinition to resolve it's initial value without having to hold onto the entire syntax tree for a source file.
boolean	hasParenthesis() Determines whether this expression is surrounded by parenthesis.
boolean	isDynamicExpression(ICompilerProject project) Does this expression evaluate to a dynamic value
IDefinition	resolve(ICompilerProject project) If this expression is statically known to refer to a definition return a reference to that definition.
ITypeDefinition	resolveType(ICompilerProject project) The type of the result of this expression.

Methods inherited from interface org.apache.flex.compiler.tree.as.IASNode

contains, getAncestorOfType, getChild, getChildCount, getContainingNode, getContainingScope, getFileSpecification, getNodeID, getPackageName, getParent, getSpanningStart, getSucceedingNode, isTerminal

Methods inherited from interface org.apache.flex.compiler.common.ISourceLocation

getAbsoluteEnd, getAbsoluteStart, getColumn, getEnd, getEndColumn, getEndLine, getLine, getSourcePath, getStart

Method Detail

resolveType

ITypeDefinition resolveType(ICompilerProject project)

The type of the result of this expression. This method returns the IDefinition representing the type that is the result of this expression. This can differ from the IDefinition you get from resolve(), such as when called on a FunctionCallNode: resolve() will return the IDefinition for the Function, whereas resolveType() will return the return type of the Function.

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

The ITypeDefinition of the type this expression results in.

resolve

IDefinition resolve(ICompilerProject project)

If this expression is statically known to refer to a definition return a reference to that definition. In many cases this will return the same definition as resolveType, but when an identifier resolves to an member variable or member function of a class, this method will return the IDefinition for the member variable or member function not the definition for the type of the member variable or the member function.

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

The IDefinition this expression refers to.

isDynamicExpression

boolean isDynamicExpression(ICompilerProject project)

Does this expression evaluate to a dynamic value

Parameters:

project - The ICompilerProject to use to do lookups.

Returns:

true if we evaluate to something dynamic

hasParenthesis

boolean hasParenthesis()

Determines whether this expression is surrounded by parenthesis. Nested parenthesis are reduced to the smallest number needed to maintain code meaning

Returns:

true if surrounded by parenthesis

copyForInitializer

IExpressionNode copyForInitializer(IScopedNode scopeNode)

Return a copy of this IExpressionNode and all it's children that can be used by VariableDefinition to resolve it's initial value without having to hold onto the entire syntax tree for a source file. Not all expressions will be copy-able - e.g. a function expression won't be successfully copied, but that is OK because we can't constant evaluate a function expression anyways.

Returns:

a new IExpressionNode that is not tied to the syntax tree it came from. If a copy can not be generated, null is returned.