Index: pkg/analyzer_experimental/lib/src/generated/ast.dart |
diff --git a/pkg/analyzer_experimental/lib/src/generated/ast.dart b/pkg/analyzer_experimental/lib/src/generated/ast.dart |
index 6b7d52580cc96425df8b72cdf3f0416c5db2f0e0..bbca83be0a35bac8cd30a64afbc29d07b359c2d8 100644 |
--- a/pkg/analyzer_experimental/lib/src/generated/ast.dart |
+++ b/pkg/analyzer_experimental/lib/src/generated/ast.dart |
@@ -13,6 +13,7 @@ import 'element.dart'; |
/** |
* The abstract class `ASTNode` defines the behavior common to all nodes in the AST structure |
* for a Dart program. |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class ASTNode { |
@@ -29,7 +30,8 @@ abstract class ASTNode { |
Map<String, Object> _propertyMap; |
/** |
- * A comparator that can be used to sort AST nodes in lexical order. In other words,`compare` will return a negative value if the offset of the first node is less than the |
+ * A comparator that can be used to sort AST nodes in lexical order. In other words, |
+ * `compare` will return a negative value if the offset of the first node is less than the |
* offset of the second node, zero (0) if the nodes have the same offset, and a positive value if |
* if the offset of the first node is greater than the offset of the second node. |
*/ |
@@ -37,6 +39,7 @@ abstract class ASTNode { |
/** |
* Use the given visitor to visit this node. |
+ * |
* @param visitor the visitor that will visit this node |
* @return the value returned by the visitor as a result of visiting this node |
*/ |
@@ -44,7 +47,7 @@ abstract class ASTNode { |
/** |
* @return the [ASTNode] of given [Class] which is [ASTNode] itself, or one of |
- * its parents. |
+ * its parents. |
*/ |
ASTNode getAncestor(Type enclosingClass) { |
ASTNode node = this; |
@@ -57,6 +60,7 @@ abstract class ASTNode { |
/** |
* Return the first token included in this node's source range. |
+ * |
* @return the first token included in this node's source range |
*/ |
Token get beginToken; |
@@ -66,18 +70,21 @@ abstract class ASTNode { |
* source range. This is equivalent to `node.getOffset() + node.getLength()`. For a |
* compilation unit this will be equal to the length of the unit's source. For synthetic nodes |
* this will be equivalent to the node's offset (because the length is zero (0) by definition). |
+ * |
* @return the offset of the character just past the node's source range |
*/ |
int get end => offset + length; |
/** |
* Return the last token included in this node's source range. |
+ * |
* @return the last token included in this node's source range |
*/ |
Token get endToken; |
/** |
* Return the number of characters in the node's source range. |
+ * |
* @return the number of characters in the node's source range |
*/ |
int get length { |
@@ -92,8 +99,9 @@ abstract class ASTNode { |
/** |
* Return the offset from the beginning of the file to the first character in the node's source |
* range. |
+ * |
* @return the offset from the beginning of the file to the first character in the node's source |
- * range |
+ * range |
*/ |
int get offset { |
Token beginToken = this.beginToken; |
@@ -108,6 +116,7 @@ abstract class ASTNode { |
* |
* Note that the relationship between an AST node and its parent node may change over the lifetime |
* of a node. |
+ * |
* @return the parent of this node, or `null` if none |
*/ |
ASTNode get parent => _parent; |
@@ -115,6 +124,7 @@ abstract class ASTNode { |
/** |
* Return the value of the property with the given name, or `null` if this node does not |
* have a property with the given name. |
+ * |
* @return the value of the property with the given name |
*/ |
Object getProperty(String propertyName) { |
@@ -127,6 +137,7 @@ abstract class ASTNode { |
/** |
* Return the node at the root of this node's AST structure. Note that this method's performance |
* is linear with respect to the depth of the node in the AST structure (O(depth)). |
+ * |
* @return the node at the root of this node's AST structure |
*/ |
ASTNode get root { |
@@ -143,12 +154,15 @@ abstract class ASTNode { |
* Return `true` if this node is a synthetic node. A synthetic node is a node that was |
* introduced by the parser in order to recover from an error in the code. Synthetic nodes always |
* have a length of zero (`0`). |
+ * |
* @return `true` if this node is a synthetic node |
*/ |
bool get isSynthetic => false; |
/** |
- * Set the value of the property with the given name to the given value. If the value is`null`, the property will effectively be removed. |
+ * Set the value of the property with the given name to the given value. If the value is |
+ * `null`, the property will effectively be removed. |
+ * |
* @param propertyName the name of the property whose value is to be set |
* @param propertyValue the new value of the property |
*/ |
@@ -171,6 +185,7 @@ abstract class ASTNode { |
/** |
* Return a textual description of this node in a form approximating valid source. The returned |
* string will not be valid source primarily in the case where the node itself is not well-formed. |
+ * |
* @return the source code equivalent of this node |
*/ |
String toSource() { |
@@ -183,12 +198,14 @@ abstract class ASTNode { |
/** |
* Use the given visitor to visit all of the children of this node. The children will be visited |
* in source order. |
+ * |
* @param visitor the visitor that will be used to visit the children of this node |
*/ |
void visitChildren(ASTVisitor<Object> visitor); |
/** |
* Make this node the parent of the given child node. |
+ * |
* @param child the node that will become a child of this node |
* @return the node that was made a child of this node |
*/ |
@@ -202,6 +219,7 @@ abstract class ASTNode { |
/** |
* If the given child is not `null`, use the given visitor to visit it. |
+ * |
* @param child the child to be visited |
* @param visitor the visitor that will be used to visit the child |
*/ |
@@ -213,6 +231,7 @@ abstract class ASTNode { |
/** |
* Set the parent of this node to the given node. |
+ * |
* @param newParent the node that is to be made the parent of this node |
*/ |
void set parent(ASTNode newParent) { |
@@ -224,6 +243,7 @@ abstract class ASTNode { |
/** |
* The interface `ASTVisitor` defines the behavior of objects that can be used to visit an AST |
* structure. |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class ASTVisitor<R> { |
@@ -335,9 +355,12 @@ abstract class ASTVisitor<R> { |
* |
* While the grammar only allows adjacent strings when all of the strings are of the same kind |
* (single line or multi-line), this class doesn't enforce that restriction. |
+ * |
* <pre> |
- * adjacentStrings ::=[StringLiteral string] [StringLiteral string]+ |
+ * adjacentStrings ::= |
+ * [StringLiteral] [StringLiteral]+ |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class AdjacentStrings extends StringLiteral { |
@@ -349,6 +372,7 @@ class AdjacentStrings extends StringLiteral { |
/** |
* Initialize a newly created list of adjacent strings. |
+ * |
* @param strings the strings that are implicitly concatenated |
*/ |
AdjacentStrings.full(List<StringLiteral> strings) { |
@@ -358,6 +382,7 @@ class AdjacentStrings extends StringLiteral { |
/** |
* Initialize a newly created list of adjacent strings. |
+ * |
* @param strings the strings that are implicitly concatenated |
*/ |
AdjacentStrings({List<StringLiteral> strings}) : this.full(strings); |
@@ -367,6 +392,7 @@ class AdjacentStrings extends StringLiteral { |
/** |
* Return the strings that are implicitly concatenated. |
+ * |
* @return the strings that are implicitly concatenated |
*/ |
NodeList<StringLiteral> get strings => _strings; |
@@ -382,6 +408,7 @@ class AdjacentStrings extends StringLiteral { |
/** |
* The abstract class `AnnotatedNode` defines the behavior of nodes that can be annotated with |
* both a comment and metadata. |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class AnnotatedNode extends ASTNode { |
@@ -399,6 +426,7 @@ abstract class AnnotatedNode extends ASTNode { |
/** |
* Initialize a newly created node. |
+ * |
* @param comment the documentation comment associated with this node |
* @param metadata the annotations associated with this node |
*/ |
@@ -410,6 +438,7 @@ abstract class AnnotatedNode extends ASTNode { |
/** |
* Initialize a newly created node. |
+ * |
* @param comment the documentation comment associated with this node |
* @param metadata the annotations associated with this node |
*/ |
@@ -435,18 +464,21 @@ abstract class AnnotatedNode extends ASTNode { |
/** |
* Return the documentation comment associated with this node, or `null` if this node does |
* not have a documentation comment associated with it. |
+ * |
* @return the documentation comment associated with this node |
*/ |
Comment get documentationComment => _comment; |
/** |
* Return the annotations associated with this node. |
+ * |
* @return the annotations associated with this node |
*/ |
NodeList<Annotation> get metadata => _metadata; |
/** |
* Set the documentation comment associated with this node to the given comment. |
+ * |
* @param comment the documentation comment to be associated with this node |
*/ |
void set documentationComment(Comment comment2) { |
@@ -455,6 +487,7 @@ abstract class AnnotatedNode extends ASTNode { |
/** |
* Set the metadata associated with this node to the given metadata. |
+ * |
* @param metadata the metadata to be associated with this node |
*/ |
void set metadata(List<Annotation> metadata2) { |
@@ -474,12 +507,14 @@ abstract class AnnotatedNode extends ASTNode { |
/** |
* Return the first token following the comment and metadata. |
+ * |
* @return the first token following the comment and metadata |
*/ |
Token get firstTokenAfterCommentAndMetadata; |
/** |
* Return `true` if the comment is lexically before any annotations. |
+ * |
* @return `true` if the comment is lexically before any annotations |
*/ |
bool commentIsBeforeAnnotations() { |
@@ -493,8 +528,9 @@ abstract class AnnotatedNode extends ASTNode { |
/** |
* Return an array containing the comment and annotations associated with this node, sorted in |
* lexical order. |
+ * |
* @return the comment and annotations associated with this node in the order in which they |
- * appeared in the original source |
+ * appeared in the original source |
*/ |
List<ASTNode> get sortedCommentAndAnnotations { |
List<ASTNode> childList = new List<ASTNode>(); |
@@ -508,12 +544,15 @@ abstract class AnnotatedNode extends ASTNode { |
/** |
* Instances of the class `Annotation` represent an annotation that can be associated with an |
* AST node. |
+ * |
* <pre> |
* metadata ::= |
- * annotation |
+ * annotation* |
+ * |
* annotation ::= |
- * '@' [Identifier qualified] ('.' [SimpleIdentifier identifier])? [ArgumentList arguments]? |
+ * '@' [Identifier] ('.' [SimpleIdentifier])? [ArgumentList]? |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class Annotation extends ASTNode { |
@@ -548,16 +587,23 @@ class Annotation extends ASTNode { |
ArgumentList _arguments; |
/** |
+ * The element associated with this annotation, or `null` if the AST structure has not been |
+ * resolved or if this annotation could not be resolved. |
+ */ |
+ Element _element; |
+ |
+ /** |
* Initialize a newly created annotation. |
+ * |
* @param atSign the at sign that introduced the annotation |
* @param name the name of the class defining the constructor that is being invoked or the name of |
- * the field that is being referenced |
+ * the field that is being referenced |
* @param period the period before the constructor name, or `null` if this annotation is not |
- * the invocation of a named constructor |
+ * the invocation of a named constructor |
* @param constructorName the name of the constructor being invoked, or `null` if this |
- * annotation is not the invocation of a named constructor |
+ * annotation is not the invocation of a named constructor |
* @param arguments the arguments to the constructor being invoked, or `null` if this |
- * annotation is not the invocation of a constructor |
+ * annotation is not the invocation of a constructor |
*/ |
Annotation.full(Token atSign, Identifier name, Token period, SimpleIdentifier constructorName, ArgumentList arguments) { |
this._atSign = atSign; |
@@ -569,15 +615,16 @@ class Annotation extends ASTNode { |
/** |
* Initialize a newly created annotation. |
+ * |
* @param atSign the at sign that introduced the annotation |
* @param name the name of the class defining the constructor that is being invoked or the name of |
- * the field that is being referenced |
+ * the field that is being referenced |
* @param period the period before the constructor name, or `null` if this annotation is not |
- * the invocation of a named constructor |
+ * the invocation of a named constructor |
* @param constructorName the name of the constructor being invoked, or `null` if this |
- * annotation is not the invocation of a named constructor |
+ * annotation is not the invocation of a named constructor |
* @param arguments the arguments to the constructor being invoked, or `null` if this |
- * annotation is not the invocation of a constructor |
+ * annotation is not the invocation of a constructor |
*/ |
Annotation({Token atSign, Identifier name, Token period, SimpleIdentifier constructorName, ArgumentList arguments}) : this.full(atSign, name, period, constructorName, arguments); |
accept(ASTVisitor visitor) => visitor.visitAnnotation(this); |
@@ -585,12 +632,14 @@ class Annotation extends ASTNode { |
/** |
* Return the arguments to the constructor being invoked, or `null` if this annotation is |
* not the invocation of a constructor. |
+ * |
* @return the arguments to the constructor being invoked |
*/ |
ArgumentList get arguments => _arguments; |
/** |
* Return the at sign that introduced the annotation. |
+ * |
* @return the at sign that introduced the annotation |
*/ |
Token get atSign => _atSign; |
@@ -599,6 +648,7 @@ class Annotation extends ASTNode { |
/** |
* Return the name of the constructor being invoked, or `null` if this annotation is not the |
* invocation of a named constructor. |
+ * |
* @return the name of the constructor being invoked |
*/ |
SimpleIdentifier get constructorName => _constructorName; |
@@ -606,12 +656,14 @@ class Annotation extends ASTNode { |
/** |
* Return the element associated with this annotation, or `null` if the AST structure has |
* not been resolved or if this annotation could not be resolved. |
+ * |
* @return the element associated with this annotation |
*/ |
Element get element { |
- if (_constructorName != null) { |
- return _constructorName.element; |
- } else if (_name != null) { |
+ if (_element != null) { |
+ return _element; |
+ } |
+ if (_name != null) { |
return _name.element; |
} |
return null; |
@@ -628,6 +680,7 @@ class Annotation extends ASTNode { |
/** |
* Return the name of the class defining the constructor that is being invoked or the name of the |
* field that is being referenced. |
+ * |
* @return the name of the constructor being invoked or the name of the field being referenced |
*/ |
Identifier get name => _name; |
@@ -635,12 +688,14 @@ class Annotation extends ASTNode { |
/** |
* Return the period before the constructor name, or `null` if this annotation is not the |
* invocation of a named constructor. |
+ * |
* @return the period before the constructor name |
*/ |
Token get period => _period; |
/** |
* Set the arguments to the constructor being invoked to the given arguments. |
+ * |
* @param arguments the arguments to the constructor being invoked |
*/ |
void set arguments(ArgumentList arguments2) { |
@@ -649,6 +704,7 @@ class Annotation extends ASTNode { |
/** |
* Set the at sign that introduced the annotation to the given token. |
+ * |
* @param atSign the at sign that introduced the annotation |
*/ |
void set atSign(Token atSign2) { |
@@ -657,6 +713,7 @@ class Annotation extends ASTNode { |
/** |
* Set the name of the constructor being invoked to the given name. |
+ * |
* @param constructorName the name of the constructor being invoked |
*/ |
void set constructorName(SimpleIdentifier constructorName2) { |
@@ -664,8 +721,18 @@ class Annotation extends ASTNode { |
} |
/** |
+ * Set the element associated with this annotation based. |
+ * |
+ * @param element the element to be associated with this identifier |
+ */ |
+ void set element(Element element2) { |
+ this._element = element2; |
+ } |
+ |
+ /** |
* Set the name of the class defining the constructor that is being invoked or the name of the |
* field that is being referenced to the given name. |
+ * |
* @param name the name of the constructor being invoked or the name of the field being referenced |
*/ |
void set name(Identifier name2) { |
@@ -674,6 +741,7 @@ class Annotation extends ASTNode { |
/** |
* Set the period before the constructor name to the given token. |
+ * |
* @param period the period before the constructor name |
*/ |
void set period(Token period2) { |
@@ -687,9 +755,12 @@ class Annotation extends ASTNode { |
} |
/** |
* Instances of the class `ArgumentDefinitionTest` represent an argument definition test. |
+ * |
* <pre> |
* argumentDefinitionTest ::= |
- * '?' [SimpleIdentifier identifier]</pre> |
+ * '?' [SimpleIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ArgumentDefinitionTest extends Expression { |
@@ -706,6 +777,7 @@ class ArgumentDefinitionTest extends Expression { |
/** |
* Initialize a newly created argument definition test. |
+ * |
* @param question the token representing the question mark |
* @param identifier the identifier representing the argument being tested |
*/ |
@@ -716,6 +788,7 @@ class ArgumentDefinitionTest extends Expression { |
/** |
* Initialize a newly created argument definition test. |
+ * |
* @param question the token representing the question mark |
* @param identifier the identifier representing the argument being tested |
*/ |
@@ -726,18 +799,21 @@ class ArgumentDefinitionTest extends Expression { |
/** |
* Return the identifier representing the argument being tested. |
+ * |
* @return the identifier representing the argument being tested |
*/ |
SimpleIdentifier get identifier => _identifier; |
/** |
* Return the token representing the question mark. |
+ * |
* @return the token representing the question mark |
*/ |
Token get question => _question; |
/** |
* Set the identifier representing the argument being tested to the given identifier. |
+ * |
* @param identifier the identifier representing the argument being tested |
*/ |
void set identifier(SimpleIdentifier identifier2) { |
@@ -746,6 +822,7 @@ class ArgumentDefinitionTest extends Expression { |
/** |
* Set the token representing the question mark to the given token. |
+ * |
* @param question the token representing the question mark |
*/ |
void set question(Token question2) { |
@@ -758,12 +835,16 @@ class ArgumentDefinitionTest extends Expression { |
/** |
* Instances of the class `ArgumentList` represent a list of arguments in the invocation of a |
* executable element: a function, method, or constructor. |
+ * |
* <pre> |
* argumentList ::= |
- * '(' arguments? ')' |
- * arguments ::=[NamedExpression namedArgument] (',' [NamedExpression namedArgument]) |
- * | [Expression expressionList] (',' [NamedExpression namedArgument]) |
+ * '(' arguments? ')' |
+ * |
+ * arguments ::= |
+ * [NamedExpression] (',' [NamedExpression])* |
+ * | [Expression] (',' [NamedExpression])* |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ArgumentList extends ASTNode { |
@@ -803,6 +884,7 @@ class ArgumentList extends ASTNode { |
/** |
* Initialize a newly created list of arguments. |
+ * |
* @param leftParenthesis the left parenthesis |
* @param arguments the expressions producing the values of the arguments |
* @param rightParenthesis the right parenthesis |
@@ -816,6 +898,7 @@ class ArgumentList extends ASTNode { |
/** |
* Initialize a newly created list of arguments. |
+ * |
* @param leftParenthesis the left parenthesis |
* @param arguments the expressions producing the values of the arguments |
* @param rightParenthesis the right parenthesis |
@@ -827,6 +910,7 @@ class ArgumentList extends ASTNode { |
* Return the expressions producing the values of the arguments. Although the language requires |
* that positional arguments appear before named arguments, this class allows them to be |
* intermixed. |
+ * |
* @return the expressions producing the values of the arguments |
*/ |
NodeList<Expression> get arguments => _arguments; |
@@ -835,12 +919,14 @@ class ArgumentList extends ASTNode { |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
@@ -850,6 +936,7 @@ class ArgumentList extends ASTNode { |
* array of parameters. The array of parameters must be the same length as the number of |
* arguments, but can contain `null` entries if a given argument does not correspond to a |
* formal parameter. |
+ * |
* @param parameters the parameter elements corresponding to the arguments |
*/ |
void set correspondingParameters(List<ParameterElement> parameters) { |
@@ -864,6 +951,7 @@ class ArgumentList extends ASTNode { |
* array of parameters. The array of parameters must be the same length as the number of |
* arguments, but can contain `null` entries if a given argument does not correspond to a |
* formal parameter. |
+ * |
* @param parameters the parameter elements corresponding to the arguments |
*/ |
void set correspondingStaticParameters(List<ParameterElement> parameters) { |
@@ -875,6 +963,7 @@ class ArgumentList extends ASTNode { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param parenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token parenthesis) { |
@@ -883,6 +972,7 @@ class ArgumentList extends ASTNode { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param parenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token parenthesis) { |
@@ -900,9 +990,10 @@ class ArgumentList extends ASTNode { |
* Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getParameterElement]. |
+ * |
* @param expression the expression corresponding to the parameter to be returned |
* @return the parameter element representing the parameter to which the value of the expression |
- * will be bound |
+ * will be bound |
*/ |
ParameterElement getPropagatedParameterElementFor(Expression expression) { |
if (_correspondingPropagatedParameters == null) { |
@@ -923,9 +1014,10 @@ class ArgumentList extends ASTNode { |
* Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getStaticParameterElement]. |
+ * |
* @param expression the expression corresponding to the parameter to be returned |
* @return the parameter element representing the parameter to which the value of the expression |
- * will be bound |
+ * will be bound |
*/ |
ParameterElement getStaticParameterElementFor(Expression expression) { |
if (_correspondingStaticParameters == null) { |
@@ -940,8 +1032,12 @@ class ArgumentList extends ASTNode { |
} |
/** |
* Instances of the class `AsExpression` represent an 'as' expression. |
+ * |
* <pre> |
- * asExpression ::=[Expression expression] 'as' [TypeName type]</pre> |
+ * asExpression ::= |
+ * [Expression] 'as' [TypeName] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class AsExpression extends Expression { |
@@ -963,6 +1059,7 @@ class AsExpression extends Expression { |
/** |
* Initialize a newly created as expression. |
+ * |
* @param expression the expression used to compute the value being cast |
* @param isOperator the is operator |
* @param type the name of the type being cast to |
@@ -975,6 +1072,7 @@ class AsExpression extends Expression { |
/** |
* Initialize a newly created as expression. |
+ * |
* @param expression the expression used to compute the value being cast |
* @param isOperator the is operator |
* @param type the name of the type being cast to |
@@ -984,6 +1082,7 @@ class AsExpression extends Expression { |
/** |
* Return the is operator being applied. |
+ * |
* @return the is operator being applied |
*/ |
Token get asOperator => _asOperator; |
@@ -992,18 +1091,21 @@ class AsExpression extends Expression { |
/** |
* Return the expression used to compute the value being cast. |
+ * |
* @return the expression used to compute the value being cast |
*/ |
Expression get expression => _expression; |
/** |
* Return the name of the type being cast to. |
+ * |
* @return the name of the type being cast to |
*/ |
TypeName get type => _type; |
/** |
* Set the is operator being applied to the given operator. |
+ * |
* @param asOperator the is operator being applied |
*/ |
void set asOperator(Token asOperator2) { |
@@ -1012,6 +1114,7 @@ class AsExpression extends Expression { |
/** |
* Set the expression used to compute the value being cast to the given expression. |
+ * |
* @param expression the expression used to compute the value being cast |
*/ |
void set expression(Expression expression2) { |
@@ -1020,6 +1123,7 @@ class AsExpression extends Expression { |
/** |
* Set the name of the type being cast to to the given name. |
+ * |
* @param name the name of the type being cast to |
*/ |
void set type(TypeName name) { |
@@ -1032,10 +1136,12 @@ class AsExpression extends Expression { |
} |
/** |
* Instances of the class `AssertStatement` represent an assert statement. |
+ * |
* <pre> |
* assertStatement ::= |
- * 'assert' '(' [Expression conditionalExpression] ')' ';' |
+ * 'assert' '(' [Expression] ')' ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class AssertStatement extends Statement { |
@@ -1067,6 +1173,7 @@ class AssertStatement extends Statement { |
/** |
* Initialize a newly created assert statement. |
+ * |
* @param keyword the token representing the 'assert' keyword |
* @param leftParenthesis the left parenthesis |
* @param condition the condition that is being asserted to be `true` |
@@ -1083,6 +1190,7 @@ class AssertStatement extends Statement { |
/** |
* Initialize a newly created assert statement. |
+ * |
* @param keyword the token representing the 'assert' keyword |
* @param leftParenthesis the left parenthesis |
* @param condition the condition that is being asserted to be `true` |
@@ -1095,6 +1203,7 @@ class AssertStatement extends Statement { |
/** |
* Return the condition that is being asserted to be `true`. |
+ * |
* @return the condition that is being asserted to be `true` |
*/ |
Expression get condition => _condition; |
@@ -1102,30 +1211,35 @@ class AssertStatement extends Statement { |
/** |
* Return the token representing the 'assert' keyword. |
+ * |
* @return the token representing the 'assert' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the condition that is being asserted to be `true` to the given expression. |
+ * |
* @param the condition that is being asserted to be `true` |
*/ |
void set condition(Expression condition2) { |
@@ -1134,6 +1248,7 @@ class AssertStatement extends Statement { |
/** |
* Set the token representing the 'assert' keyword to the given token. |
+ * |
* @param keyword the token representing the 'assert' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -1142,6 +1257,7 @@ class AssertStatement extends Statement { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param the left parenthesis |
*/ |
void set leftParenthesis(Token leftParenthesis2) { |
@@ -1150,6 +1266,7 @@ class AssertStatement extends Statement { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param rightParenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token rightParenthesis2) { |
@@ -1158,6 +1275,7 @@ class AssertStatement extends Statement { |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -1169,8 +1287,12 @@ class AssertStatement extends Statement { |
} |
/** |
* Instances of the class `AssignmentExpression` represent an assignment expression. |
+ * |
* <pre> |
- * assignmentExpression ::=[Expression leftHandSide] [Token operator] [Expression rightHandSide]</pre> |
+ * assignmentExpression ::= |
+ * [Expression] [Token] [Expression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class AssignmentExpression extends Expression { |
@@ -1191,19 +1313,22 @@ class AssignmentExpression extends Expression { |
Expression _rightHandSide; |
/** |
- * The element associated with the operator based on the static type of the left-hand-side, or`null` if the AST structure has not been resolved, if the operator is not a compound |
+ * The element associated with the operator based on the static type of the left-hand-side, or |
+ * `null` if the AST structure has not been resolved, if the operator is not a compound |
* operator, or if the operator could not be resolved. |
*/ |
MethodElement _staticElement; |
/** |
- * The element associated with the operator based on the propagated type of the left-hand-side, or`null` if the AST structure has not been resolved, if the operator is not a compound |
+ * The element associated with the operator based on the propagated type of the left-hand-side, or |
+ * `null` if the AST structure has not been resolved, if the operator is not a compound |
* operator, or if the operator could not be resolved. |
*/ |
MethodElement _propagatedElement; |
/** |
* Initialize a newly created assignment expression. |
+ * |
* @param leftHandSide the expression used to compute the left hand side |
* @param operator the assignment operator being applied |
* @param rightHandSide the expression used to compute the right hand side |
@@ -1216,6 +1341,7 @@ class AssignmentExpression extends Expression { |
/** |
* Initialize a newly created assignment expression. |
+ * |
* @param leftHandSide the expression used to compute the left hand side |
* @param operator the assignment operator being applied |
* @param rightHandSide the expression used to compute the right hand side |
@@ -1229,6 +1355,7 @@ class AssignmentExpression extends Expression { |
* left-hand-side, or `null` if the AST structure has not been resolved, if the operator is |
* not a compound operator, or if the operator could not be resolved. One example of the latter |
* case is an operator that is not defined for the type of the left-hand operand. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get element => _propagatedElement; |
@@ -1236,18 +1363,21 @@ class AssignmentExpression extends Expression { |
/** |
* Set the expression used to compute the left hand side to the given expression. |
+ * |
* @return the expression used to compute the left hand side |
*/ |
Expression get leftHandSide => _leftHandSide; |
/** |
* Return the assignment operator being applied. |
+ * |
* @return the assignment operator being applied |
*/ |
Token get operator => _operator; |
/** |
* Return the expression used to compute the right hand side. |
+ * |
* @return the expression used to compute the right hand side |
*/ |
Expression get rightHandSide => _rightHandSide; |
@@ -1257,6 +1387,7 @@ class AssignmentExpression extends Expression { |
* or `null` if the AST structure has not been resolved, if the operator is not a compound |
* operator, or if the operator could not be resolved. One example of the latter case is an |
* operator that is not defined for the type of the left-hand operand. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get staticElement => _staticElement; |
@@ -1264,6 +1395,7 @@ class AssignmentExpression extends Expression { |
/** |
* Set the element associated with the operator based on the propagated type of the left-hand-side |
* to the given element. |
+ * |
* @param element the element to be associated with the operator |
*/ |
void set element(MethodElement element2) { |
@@ -1272,6 +1404,7 @@ class AssignmentExpression extends Expression { |
/** |
* Return the expression used to compute the left hand side. |
+ * |
* @param expression the expression used to compute the left hand side |
*/ |
void set leftHandSide(Expression expression) { |
@@ -1280,6 +1413,7 @@ class AssignmentExpression extends Expression { |
/** |
* Set the assignment operator being applied to the given operator. |
+ * |
* @param operator the assignment operator being applied |
*/ |
void set operator(Token operator2) { |
@@ -1288,6 +1422,7 @@ class AssignmentExpression extends Expression { |
/** |
* Set the expression used to compute the left hand side to the given expression. |
+ * |
* @param expression the expression used to compute the left hand side |
*/ |
void set rightHandSide(Expression expression) { |
@@ -1297,6 +1432,7 @@ class AssignmentExpression extends Expression { |
/** |
* Set the element associated with the operator based on the static type of the left-hand-side to |
* the given element. |
+ * |
* @param element the static element to be associated with the operator |
*/ |
void set staticElement(MethodElement element) { |
@@ -1309,8 +1445,12 @@ class AssignmentExpression extends Expression { |
} |
/** |
* Instances of the class `BinaryExpression` represent a binary (infix) expression. |
+ * |
* <pre> |
- * binaryExpression ::=[Expression leftOperand] [Token operator] [Expression rightOperand]</pre> |
+ * binaryExpression ::= |
+ * [Expression] [Token] [Expression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class BinaryExpression extends Expression { |
@@ -1331,19 +1471,22 @@ class BinaryExpression extends Expression { |
Expression _rightOperand; |
/** |
- * The element associated with the operator based on the static type of the left operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * The element associated with the operator based on the static type of the left operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. |
*/ |
MethodElement _staticElement; |
/** |
- * The element associated with the operator based on the propagated type of the left operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * The element associated with the operator based on the propagated type of the left operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. |
*/ |
MethodElement _propagatedElement; |
/** |
* Initialize a newly created binary expression. |
+ * |
* @param leftOperand the expression used to compute the left operand |
* @param operator the binary operator being applied |
* @param rightOperand the expression used to compute the right operand |
@@ -1356,6 +1499,7 @@ class BinaryExpression extends Expression { |
/** |
* Initialize a newly created binary expression. |
+ * |
* @param leftOperand the expression used to compute the left operand |
* @param operator the binary operator being applied |
* @param rightOperand the expression used to compute the right operand |
@@ -1369,6 +1513,7 @@ class BinaryExpression extends Expression { |
* operand, or `null` if the AST structure has not been resolved, if the operator is not |
* user definable, or if the operator could not be resolved. One example of the latter case is an |
* operator that is not defined for the type of the left-hand operand. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get element => _propagatedElement; |
@@ -1376,18 +1521,21 @@ class BinaryExpression extends Expression { |
/** |
* Return the expression used to compute the left operand. |
+ * |
* @return the expression used to compute the left operand |
*/ |
Expression get leftOperand => _leftOperand; |
/** |
* Return the binary operator being applied. |
+ * |
* @return the binary operator being applied |
*/ |
Token get operator => _operator; |
/** |
* Return the expression used to compute the right operand. |
+ * |
* @return the expression used to compute the right operand |
*/ |
Expression get rightOperand => _rightOperand; |
@@ -1397,6 +1545,7 @@ class BinaryExpression extends Expression { |
* or `null` if the AST structure has not been resolved, if the operator is not user |
* definable, or if the operator could not be resolved. One example of the latter case is an |
* operator that is not defined for the type of the left operand. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get staticElement => _staticElement; |
@@ -1404,6 +1553,7 @@ class BinaryExpression extends Expression { |
/** |
* Set the element associated with the operator based on the propagated type of the left operand |
* to the given element. |
+ * |
* @param element the element to be associated with the operator |
*/ |
void set element(MethodElement element2) { |
@@ -1412,6 +1562,7 @@ class BinaryExpression extends Expression { |
/** |
* Set the expression used to compute the left operand to the given expression. |
+ * |
* @param expression the expression used to compute the left operand |
*/ |
void set leftOperand(Expression expression) { |
@@ -1420,6 +1571,7 @@ class BinaryExpression extends Expression { |
/** |
* Set the binary operator being applied to the given operator. |
+ * |
* @return the binary operator being applied |
*/ |
void set operator(Token operator2) { |
@@ -1428,6 +1580,7 @@ class BinaryExpression extends Expression { |
/** |
* Set the expression used to compute the right operand to the given expression. |
+ * |
* @param expression the expression used to compute the right operand |
*/ |
void set rightOperand(Expression expression) { |
@@ -1437,6 +1590,7 @@ class BinaryExpression extends Expression { |
/** |
* Set the element associated with the operator based on the static type of the left operand to |
* the given element. |
+ * |
* @param element the static element to be associated with the operator |
*/ |
void set staticElement(MethodElement element) { |
@@ -1453,8 +1607,9 @@ class BinaryExpression extends Expression { |
* which the value of the right operand will be bound. Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getParameterElement]. |
+ * |
* @return the parameter element representing the parameter to which the value of the right |
- * operand will be bound |
+ * operand will be bound |
*/ |
ParameterElement get propagatedParameterElementForRightOperand { |
if (_propagatedElement == null) { |
@@ -1473,8 +1628,9 @@ class BinaryExpression extends Expression { |
* value of the right operand will be bound. Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getStaticParameterElement]. |
+ * |
* @return the parameter element representing the parameter to which the value of the right |
- * operand will be bound |
+ * operand will be bound |
*/ |
ParameterElement get staticParameterElementForRightOperand { |
if (_staticElement == null) { |
@@ -1489,10 +1645,12 @@ class BinaryExpression extends Expression { |
} |
/** |
* Instances of the class `Block` represent a sequence of statements. |
+ * |
* <pre> |
* block ::= |
- * '{' statement* '}' |
+ * '{' statement* '}' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class Block extends Statement { |
@@ -1514,6 +1672,7 @@ class Block extends Statement { |
/** |
* Initialize a newly created block of code. |
+ * |
* @param leftBracket the left curly bracket |
* @param statements the statements contained in the block |
* @param rightBracket the right curly bracket |
@@ -1527,6 +1686,7 @@ class Block extends Statement { |
/** |
* Initialize a newly created block of code. |
+ * |
* @param leftBracket the left curly bracket |
* @param statements the statements contained in the block |
* @param rightBracket the right curly bracket |
@@ -1538,24 +1698,28 @@ class Block extends Statement { |
/** |
* Return the left curly bracket. |
+ * |
* @return the left curly bracket |
*/ |
Token get leftBracket => _leftBracket; |
/** |
* Return the right curly bracket. |
+ * |
* @return the right curly bracket |
*/ |
Token get rightBracket => _rightBracket; |
/** |
* Return the statements contained in the block. |
+ * |
* @return the statements contained in the block |
*/ |
NodeList<Statement> get statements => _statements; |
/** |
* Set the left curly bracket to the given token. |
+ * |
* @param leftBracket the left curly bracket |
*/ |
void set leftBracket(Token leftBracket2) { |
@@ -1564,6 +1728,7 @@ class Block extends Statement { |
/** |
* Set the right curly bracket to the given token. |
+ * |
* @param rightBracket the right curly bracket |
*/ |
void set rightBracket(Token rightBracket2) { |
@@ -1576,8 +1741,12 @@ class Block extends Statement { |
/** |
* Instances of the class `BlockFunctionBody` represent a function body that consists of a |
* block of statements. |
+ * |
* <pre> |
- * blockFunctionBody ::=[Block block]</pre> |
+ * blockFunctionBody ::= |
+ * [Block] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class BlockFunctionBody extends FunctionBody { |
@@ -1589,6 +1758,7 @@ class BlockFunctionBody extends FunctionBody { |
/** |
* Initialize a newly created function body consisting of a block of statements. |
+ * |
* @param block the block representing the body of the function |
*/ |
BlockFunctionBody.full(Block block) { |
@@ -1597,6 +1767,7 @@ class BlockFunctionBody extends FunctionBody { |
/** |
* Initialize a newly created function body consisting of a block of statements. |
+ * |
* @param block the block representing the body of the function |
*/ |
BlockFunctionBody({Block block}) : this.full(block); |
@@ -1605,6 +1776,7 @@ class BlockFunctionBody extends FunctionBody { |
/** |
* Return the block representing the body of the function. |
+ * |
* @return the block representing the body of the function |
*/ |
Block get block => _block; |
@@ -1612,6 +1784,7 @@ class BlockFunctionBody extends FunctionBody { |
/** |
* Set the block representing the body of the function to the given block. |
+ * |
* @param block the block representing the body of the function |
*/ |
void set block(Block block2) { |
@@ -1623,10 +1796,12 @@ class BlockFunctionBody extends FunctionBody { |
} |
/** |
* Instances of the class `BooleanLiteral` represent a boolean literal expression. |
+ * |
* <pre> |
* booleanLiteral ::= |
- * 'false' | 'true' |
+ * 'false' | 'true' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class BooleanLiteral extends Literal { |
@@ -1643,6 +1818,7 @@ class BooleanLiteral extends Literal { |
/** |
* Initialize a newly created boolean literal. |
+ * |
* @param literal the token representing the literal |
* @param value the value of the literal |
*/ |
@@ -1653,6 +1829,7 @@ class BooleanLiteral extends Literal { |
/** |
* Initialize a newly created boolean literal. |
+ * |
* @param literal the token representing the literal |
* @param value the value of the literal |
*/ |
@@ -1663,12 +1840,14 @@ class BooleanLiteral extends Literal { |
/** |
* Return the token representing the literal. |
+ * |
* @return the token representing the literal |
*/ |
Token get literal => _literal; |
/** |
* Return the value of the literal. |
+ * |
* @return the value of the literal |
*/ |
bool get value => _value; |
@@ -1676,6 +1855,7 @@ class BooleanLiteral extends Literal { |
/** |
* Set the token representing the literal to the given token. |
+ * |
* @param literal the token representing the literal |
*/ |
void set literal(Token literal2) { |
@@ -1684,6 +1864,7 @@ class BooleanLiteral extends Literal { |
/** |
* Set the value of the literal to the given value. |
+ * |
* @param value the value of the literal |
*/ |
void set value(bool value2) { |
@@ -1694,10 +1875,12 @@ class BooleanLiteral extends Literal { |
} |
/** |
* Instances of the class `BreakStatement` represent a break statement. |
+ * |
* <pre> |
* breakStatement ::= |
- * 'break' [SimpleIdentifier label]? ';' |
+ * 'break' [SimpleIdentifier]? ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class BreakStatement extends Statement { |
@@ -1719,6 +1902,7 @@ class BreakStatement extends Statement { |
/** |
* Initialize a newly created break statement. |
+ * |
* @param keyword the token representing the 'break' keyword |
* @param label the label associated with the statement |
* @param semicolon the semicolon terminating the statement |
@@ -1731,6 +1915,7 @@ class BreakStatement extends Statement { |
/** |
* Initialize a newly created break statement. |
+ * |
* @param keyword the token representing the 'break' keyword |
* @param label the label associated with the statement |
* @param semicolon the semicolon terminating the statement |
@@ -1742,24 +1927,28 @@ class BreakStatement extends Statement { |
/** |
* Return the token representing the 'break' keyword. |
+ * |
* @return the token representing the 'break' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the label associated with the statement, or `null` if there is no label. |
+ * |
* @return the label associated with the statement |
*/ |
SimpleIdentifier get label => _label; |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the token representing the 'break' keyword to the given token. |
+ * |
* @param keyword the token representing the 'break' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -1768,6 +1957,7 @@ class BreakStatement extends Statement { |
/** |
* Set the label associated with the statement to the given identifier. |
+ * |
* @param identifier the label associated with the statement |
*/ |
void set label(SimpleIdentifier identifier) { |
@@ -1776,6 +1966,7 @@ class BreakStatement extends Statement { |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -1788,15 +1979,21 @@ class BreakStatement extends Statement { |
/** |
* Instances of the class `CascadeExpression` represent a sequence of cascaded expressions: |
* expressions that share a common target. There are three kinds of expressions that can be used in |
- * a cascade expression: [IndexExpression], [MethodInvocation] and[PropertyAccess]. |
+ * a cascade expression: [IndexExpression], [MethodInvocation] and |
+ * [PropertyAccess]. |
+ * |
* <pre> |
- * cascadeExpression ::=[Expression conditionalExpression] cascadeSection |
+ * cascadeExpression ::= |
+ * [Expression] cascadeSection* |
+ * |
* cascadeSection ::= |
- * '..' (cascadeSelector arguments*) (assignableSelector arguments*)* (assignmentOperator expressionWithoutCascade)? |
+ * '..' (cascadeSelector arguments*) (assignableSelector arguments*)* (assignmentOperator expressionWithoutCascade)? |
+ * |
* cascadeSelector ::= |
- * '\[ ' expression '\] ' |
- * | identifier |
+ * '[ ' expression '] ' |
+ * | identifier |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class CascadeExpression extends Expression { |
@@ -1813,6 +2010,7 @@ class CascadeExpression extends Expression { |
/** |
* Initialize a newly created cascade expression. |
+ * |
* @param target the target of the cascade sections |
* @param cascadeSections the cascade sections sharing the common target |
*/ |
@@ -1824,6 +2022,7 @@ class CascadeExpression extends Expression { |
/** |
* Initialize a newly created cascade expression. |
+ * |
* @param target the target of the cascade sections |
* @param cascadeSections the cascade sections sharing the common target |
*/ |
@@ -1833,6 +2032,7 @@ class CascadeExpression extends Expression { |
/** |
* Return the cascade sections sharing the common target. |
+ * |
* @return the cascade sections sharing the common target |
*/ |
NodeList<Expression> get cascadeSections => _cascadeSections; |
@@ -1840,12 +2040,14 @@ class CascadeExpression extends Expression { |
/** |
* Return the target of the cascade sections. |
+ * |
* @return the target of the cascade sections |
*/ |
Expression get target => _target; |
/** |
* Set the target of the cascade sections to the given expression. |
+ * |
* @param target the target of the cascade sections |
*/ |
void set target(Expression target2) { |
@@ -1858,11 +2060,16 @@ class CascadeExpression extends Expression { |
} |
/** |
* Instances of the class `CatchClause` represent a catch clause within a try statement. |
+ * |
* <pre> |
* onPart ::= |
- * catchPart [Block block]| 'on' type catchPart? [Block block]catchPart ::= |
- * 'catch' '(' [SimpleIdentifier exceptionParameter] (',' [SimpleIdentifier stackTraceParameter])? ')' |
+ * catchPart [Block] |
+ * | 'on' type catchPart? [Block] |
+ * |
+ * catchPart ::= |
+ * 'catch' '(' [SimpleIdentifier] (',' [SimpleIdentifier])? ')' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class CatchClause extends ASTNode { |
@@ -1915,13 +2122,14 @@ class CatchClause extends ASTNode { |
/** |
* Initialize a newly created catch clause. |
+ * |
* @param onKeyword the token representing the 'on' keyword |
* @param exceptionType the type of exceptions caught by this catch clause |
* @param leftParenthesis the left parenthesis |
* @param exceptionParameter the parameter whose value will be the exception that was thrown |
* @param comma the comma separating the exception parameter from the stack trace parameter |
* @param stackTraceParameter the parameter whose value will be the stack trace associated with |
- * the exception |
+ * the exception |
* @param rightParenthesis the right parenthesis |
* @param body the body of the catch block |
*/ |
@@ -1939,13 +2147,14 @@ class CatchClause extends ASTNode { |
/** |
* Initialize a newly created catch clause. |
+ * |
* @param onKeyword the token representing the 'on' keyword |
* @param exceptionType the type of exceptions caught by this catch clause |
* @param leftParenthesis the left parenthesis |
* @param exceptionParameter the parameter whose value will be the exception that was thrown |
* @param comma the comma separating the exception parameter from the stack trace parameter |
* @param stackTraceParameter the parameter whose value will be the stack trace associated with |
- * the exception |
+ * the exception |
* @param rightParenthesis the right parenthesis |
* @param body the body of the catch block |
*/ |
@@ -1960,6 +2169,7 @@ class CatchClause extends ASTNode { |
/** |
* Return the body of the catch block. |
+ * |
* @return the body of the catch block |
*/ |
Block get body => _body; |
@@ -1967,12 +2177,14 @@ class CatchClause extends ASTNode { |
/** |
* Return the token representing the 'catch' keyword, or `null` if there is no 'catch' |
* keyword. |
+ * |
* @return the token representing the 'catch' keyword |
*/ |
Token get catchKeyword => _catchKeyword; |
/** |
* Return the comma. |
+ * |
* @return the comma |
*/ |
Token get comma => _comma; |
@@ -1980,6 +2192,7 @@ class CatchClause extends ASTNode { |
/** |
* Return the parameter whose value will be the exception that was thrown. |
+ * |
* @return the parameter whose value will be the exception that was thrown |
*/ |
SimpleIdentifier get exceptionParameter => _exceptionParameter; |
@@ -1987,36 +2200,42 @@ class CatchClause extends ASTNode { |
/** |
* Return the type of exceptions caught by this catch clause, or `null` if this catch clause |
* catches every type of exception. |
+ * |
* @return the type of exceptions caught by this catch clause |
*/ |
TypeName get exceptionType => _exceptionType; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the token representing the 'on' keyword, or `null` if there is no 'on' keyword. |
+ * |
* @return the token representing the 'on' keyword |
*/ |
Token get onKeyword => _onKeyword; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
* Return the parameter whose value will be the stack trace associated with the exception. |
+ * |
* @return the parameter whose value will be the stack trace associated with the exception |
*/ |
SimpleIdentifier get stackTraceParameter => _stackTraceParameter; |
/** |
* Set the body of the catch block to the given block. |
+ * |
* @param block the body of the catch block |
*/ |
void set body(Block block) { |
@@ -2025,6 +2244,7 @@ class CatchClause extends ASTNode { |
/** |
* Set the token representing the 'catch' keyword to the given token. |
+ * |
* @param catchKeyword the token representing the 'catch' keyword |
*/ |
void set catchKeyword(Token catchKeyword2) { |
@@ -2033,6 +2253,7 @@ class CatchClause extends ASTNode { |
/** |
* Set the comma to the given token. |
+ * |
* @param comma the comma |
*/ |
void set comma(Token comma2) { |
@@ -2041,6 +2262,7 @@ class CatchClause extends ASTNode { |
/** |
* Set the parameter whose value will be the exception that was thrown to the given parameter. |
+ * |
* @param parameter the parameter whose value will be the exception that was thrown |
*/ |
void set exceptionParameter(SimpleIdentifier parameter) { |
@@ -2049,6 +2271,7 @@ class CatchClause extends ASTNode { |
/** |
* Set the type of exceptions caught by this catch clause to the given type. |
+ * |
* @param exceptionType the type of exceptions caught by this catch clause |
*/ |
void set exceptionType(TypeName exceptionType2) { |
@@ -2057,6 +2280,7 @@ class CatchClause extends ASTNode { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param parenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token parenthesis) { |
@@ -2065,6 +2289,7 @@ class CatchClause extends ASTNode { |
/** |
* Set the token representing the 'on' keyword to the given keyword. |
+ * |
* @param onKeyword the token representing the 'on' keyword |
*/ |
void set onKeyword(Token onKeyword2) { |
@@ -2073,6 +2298,7 @@ class CatchClause extends ASTNode { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param parenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token parenthesis) { |
@@ -2082,8 +2308,9 @@ class CatchClause extends ASTNode { |
/** |
* Set the parameter whose value will be the stack trace associated with the exception to the |
* given parameter. |
+ * |
* @param parameter the parameter whose value will be the stack trace associated with the |
- * exception |
+ * exception |
*/ |
void set stackTraceParameter(SimpleIdentifier parameter) { |
_stackTraceParameter = becomeParentOf(parameter); |
@@ -2097,12 +2324,15 @@ class CatchClause extends ASTNode { |
} |
/** |
* Instances of the class `ClassDeclaration` represent the declaration of a class. |
+ * |
* <pre> |
* classDeclaration ::= |
- * 'abstract'? 'class' [SimpleIdentifier name] [TypeParameterList typeParameterList]? |
- * ([ExtendsClause extendsClause] [WithClause withClause]?)?[ImplementsClause implementsClause]? |
- * '{' [ClassMember classMember]* '}' |
+ * 'abstract'? 'class' [SimpleIdentifier] [TypeParameterList]? |
+ * ([ExtendsClause] [WithClause]?)? |
+ * [ImplementsClause]? |
+ * '{' [ClassMember]* '}' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ClassDeclaration extends CompilationUnitMember { |
@@ -2161,6 +2391,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Initialize a newly created class declaration. |
+ * |
* @param comment the documentation comment associated with this class |
* @param metadata the annotations associated with this class |
* @param abstractKeyword the 'abstract' keyword, or `null` if the keyword was absent |
@@ -2190,6 +2421,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Initialize a newly created class declaration. |
+ * |
* @param comment the documentation comment associated with this class |
* @param metadata the annotations associated with this class |
* @param abstractKeyword the 'abstract' keyword, or `null` if the keyword was absent |
@@ -2208,12 +2440,14 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Return the 'abstract' keyword, or `null` if the keyword was absent. |
+ * |
* @return the 'abstract' keyword |
*/ |
Token get abstractKeyword => _abstractKeyword; |
/** |
* Return the token representing the 'class' keyword. |
+ * |
* @return the token representing the 'class' keyword |
*/ |
Token get classKeyword => _classKeyword; |
@@ -2223,6 +2457,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Return the extends clause for this class, or `null` if the class does not extend any |
* other class. |
+ * |
* @return the extends clause for this class |
*/ |
ExtendsClause get extendsClause => _extendsClause; |
@@ -2230,30 +2465,35 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Return the implements clause for the class, or `null` if the class does not implement any |
* interfaces. |
+ * |
* @return the implements clause for the class |
*/ |
ImplementsClause get implementsClause => _implementsClause; |
/** |
* Return the left curly bracket. |
+ * |
* @return the left curly bracket |
*/ |
Token get leftBracket => _leftBracket; |
/** |
* Return the members defined by the class. |
+ * |
* @return the members defined by the class |
*/ |
NodeList<ClassMember> get members => _members; |
/** |
* Return the name of the class being declared. |
+ * |
* @return the name of the class being declared |
*/ |
SimpleIdentifier get name => _name; |
/** |
* Return the right curly bracket. |
+ * |
* @return the right curly bracket |
*/ |
Token get rightBracket => _rightBracket; |
@@ -2261,18 +2501,21 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Return the type parameters for the class, or `null` if the class does not have any type |
* parameters. |
+ * |
* @return the type parameters for the class |
*/ |
TypeParameterList get typeParameters => _typeParameters; |
/** |
* Return the with clause for the class, or `null` if the class does not have a with clause. |
+ * |
* @return the with clause for the class |
*/ |
WithClause get withClause => _withClause; |
/** |
* Set the 'abstract' keyword to the given keyword. |
+ * |
* @param abstractKeyword the 'abstract' keyword |
*/ |
void set abstractKeyword(Token abstractKeyword2) { |
@@ -2281,6 +2524,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Set the token representing the 'class' keyword to the given token. |
+ * |
* @param classKeyword the token representing the 'class' keyword |
*/ |
void set classKeyword(Token classKeyword2) { |
@@ -2289,6 +2533,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Set the extends clause for this class to the given clause. |
+ * |
* @param extendsClause the extends clause for this class |
*/ |
void set extendsClause(ExtendsClause extendsClause2) { |
@@ -2297,6 +2542,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Set the implements clause for the class to the given clause. |
+ * |
* @param implementsClause the implements clause for the class |
*/ |
void set implementsClause(ImplementsClause implementsClause2) { |
@@ -2305,6 +2551,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Set the left curly bracket to the given token. |
+ * |
* @param leftBracket the left curly bracket |
*/ |
void set leftBracket(Token leftBracket2) { |
@@ -2313,6 +2560,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Set the name of the class being declared to the given identifier. |
+ * |
* @param identifier the name of the class being declared |
*/ |
void set name(SimpleIdentifier identifier) { |
@@ -2321,6 +2569,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Set the right curly bracket to the given token. |
+ * |
* @param rightBracket the right curly bracket |
*/ |
void set rightBracket(Token rightBracket2) { |
@@ -2329,6 +2578,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Set the type parameters for the class to the given list of type parameters. |
+ * |
* @param typeParameters the type parameters for the class |
*/ |
void set typeParameters(TypeParameterList typeParameters2) { |
@@ -2337,6 +2587,7 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* Set the with clause for the class to the given clause. |
+ * |
* @param withClause the with clause for the class |
*/ |
void set withClause(WithClause withClause2) { |
@@ -2361,12 +2612,14 @@ class ClassDeclaration extends CompilationUnitMember { |
/** |
* The abstract class `ClassMember` defines the behavior common to nodes that declare a name |
* within the scope of a class. |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class ClassMember extends Declaration { |
/** |
* Initialize a newly created member of a class. |
+ * |
* @param comment the documentation comment associated with this member |
* @param metadata the annotations associated with this member |
*/ |
@@ -2375,6 +2628,7 @@ abstract class ClassMember extends Declaration { |
/** |
* Initialize a newly created member of a class. |
+ * |
* @param comment the documentation comment associated with this member |
* @param metadata the annotations associated with this member |
*/ |
@@ -2382,10 +2636,15 @@ abstract class ClassMember extends Declaration { |
} |
/** |
* Instances of the class `ClassTypeAlias` represent a class type alias. |
+ * |
* <pre> |
- * classTypeAlias ::=[SimpleIdentifier identifier] [TypeParameterList typeParameters]? '=' 'abstract'? mixinApplication |
- * mixinApplication ::=[TypeName superclass] [WithClause withClause] [ImplementsClause implementsClause]? ';' |
+ * classTypeAlias ::= |
+ * [SimpleIdentifier] [TypeParameterList]? '=' 'abstract'? mixinApplication |
+ * |
+ * mixinApplication ::= |
+ * [TypeName] [WithClause] [ImplementsClause]? ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ClassTypeAlias extends TypeAlias { |
@@ -2429,6 +2688,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Initialize a newly created class type alias. |
+ * |
* @param comment the documentation comment associated with this type alias |
* @param metadata the annotations associated with this type alias |
* @param keyword the token representing the 'typedef' keyword |
@@ -2453,6 +2713,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Initialize a newly created class type alias. |
+ * |
* @param comment the documentation comment associated with this type alias |
* @param metadata the annotations associated with this type alias |
* @param keyword the token representing the 'typedef' keyword |
@@ -2471,6 +2732,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Return the token for the 'abstract' keyword, or `null` if this is not defining an |
* abstract class. |
+ * |
* @return the token for the 'abstract' keyword |
*/ |
Token get abstractKeyword => _abstractKeyword; |
@@ -2478,24 +2740,28 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Return the token for the '=' separating the name from the definition. |
+ * |
* @return the token for the '=' separating the name from the definition |
*/ |
Token get equals => _equals; |
/** |
* Return the implements clause for this class, or `null` if there is no implements clause. |
+ * |
* @return the implements clause for this class |
*/ |
ImplementsClause get implementsClause => _implementsClause; |
/** |
* Return the name of the class being declared. |
+ * |
* @return the name of the class being declared |
*/ |
SimpleIdentifier get name => _name; |
/** |
* Return the name of the superclass of the class being declared. |
+ * |
* @return the name of the superclass of the class being declared |
*/ |
TypeName get superclass => _superclass; |
@@ -2503,18 +2769,21 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Return the type parameters for the class, or `null` if the class does not have any type |
* parameters. |
+ * |
* @return the type parameters for the class |
*/ |
TypeParameterList get typeParameters => _typeParameters; |
/** |
* Return the with clause for this class. |
+ * |
* @return the with clause for this class |
*/ |
WithClause get withClause => _withClause; |
/** |
* Set the token for the 'abstract' keyword to the given token. |
+ * |
* @param abstractKeyword the token for the 'abstract' keyword |
*/ |
void set abstractKeyword(Token abstractKeyword2) { |
@@ -2523,6 +2792,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Set the token for the '=' separating the name from the definition to the given token. |
+ * |
* @param equals the token for the '=' separating the name from the definition |
*/ |
void set equals(Token equals2) { |
@@ -2531,6 +2801,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Set the implements clause for this class to the given implements clause. |
+ * |
* @param implementsClause the implements clause for this class |
*/ |
void set implementsClause(ImplementsClause implementsClause2) { |
@@ -2539,6 +2810,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Set the name of the class being declared to the given identifier. |
+ * |
* @param name the name of the class being declared |
*/ |
void set name(SimpleIdentifier name2) { |
@@ -2547,6 +2819,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Set the name of the superclass of the class being declared to the given name. |
+ * |
* @param superclass the name of the superclass of the class being declared |
*/ |
void set superclass(TypeName superclass2) { |
@@ -2555,6 +2828,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Set the type parameters for the class to the given list of parameters. |
+ * |
* @param typeParameters the type parameters for the class |
*/ |
void set typeParameters(TypeParameterList typeParameters2) { |
@@ -2563,6 +2837,7 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Set the with clause for this class to the given with clause. |
+ * |
* @param withClause the with clause for this class |
*/ |
void set withClause(WithClause withClause2) { |
@@ -2580,8 +2855,13 @@ class ClassTypeAlias extends TypeAlias { |
/** |
* Instances of the class `Combinator` represent the combinator associated with an import |
* directive. |
+ * |
* <pre> |
- * combinator ::=[HideCombinator hideCombinator]| [ShowCombinator showCombinator]</pre> |
+ * combinator ::= |
+ * [HideCombinator] |
+ * | [ShowCombinator] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class Combinator extends ASTNode { |
@@ -2593,8 +2873,9 @@ abstract class Combinator extends ASTNode { |
/** |
* Initialize a newly created import combinator. |
+ * |
* @param keyword the keyword specifying what kind of processing is to be done on the imported |
- * names |
+ * names |
*/ |
Combinator.full(Token keyword) { |
this._keyword = keyword; |
@@ -2602,14 +2883,16 @@ abstract class Combinator extends ASTNode { |
/** |
* Initialize a newly created import combinator. |
+ * |
* @param keyword the keyword specifying what kind of processing is to be done on the imported |
- * names |
+ * names |
*/ |
Combinator({Token keyword}) : this.full(keyword); |
Token get beginToken => _keyword; |
/** |
* Return the keyword specifying what kind of processing is to be done on the imported names. |
+ * |
* @return the keyword specifying what kind of processing is to be done on the imported names |
*/ |
Token get keyword => _keyword; |
@@ -2617,8 +2900,9 @@ abstract class Combinator extends ASTNode { |
/** |
* Set the keyword specifying what kind of processing is to be done on the imported names to the |
* given token. |
+ * |
* @param keyword the keyword specifying what kind of processing is to be done on the imported |
- * names |
+ * names |
*/ |
void set keyword(Token keyword2) { |
this._keyword = keyword2; |
@@ -2626,25 +2910,31 @@ abstract class Combinator extends ASTNode { |
} |
/** |
* Instances of the class `Comment` represent a comment within the source code. |
+ * |
* <pre> |
* comment ::= |
- * endOfLineComment |
- * | blockComment |
- * | documentationComment |
+ * endOfLineComment |
+ * | blockComment |
+ * | documentationComment |
+ * |
* endOfLineComment ::= |
- * '//' (CHARACTER - EOL)* EOL |
+ * '//' (CHARACTER - EOL)* EOL |
+ * |
* blockComment ::= |
- * '/ *' CHARACTER* '*/' |
+ * '/ *' CHARACTER* '*/' |
+ * |
* documentationComment ::= |
- * '/ **' (CHARACTER | [CommentReference commentReference])* '*/' |
- * | ('///' (CHARACTER - EOL)* EOL)+ |
+ * '/ **' (CHARACTER | [CommentReference])* '*/' |
+ * | ('///' (CHARACTER - EOL)* EOL)+ |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class Comment extends ASTNode { |
/** |
* Create a block comment. |
+ * |
* @param tokens the tokens representing the comment |
* @return the block comment that was created |
*/ |
@@ -2652,6 +2942,7 @@ class Comment extends ASTNode { |
/** |
* Create a documentation comment. |
+ * |
* @param tokens the tokens representing the comment |
* @return the documentation comment that was created |
*/ |
@@ -2659,6 +2950,7 @@ class Comment extends ASTNode { |
/** |
* Create a documentation comment. |
+ * |
* @param tokens the tokens representing the comment |
* @param references the references embedded within the documentation comment |
* @return the documentation comment that was created |
@@ -2667,6 +2959,7 @@ class Comment extends ASTNode { |
/** |
* Create an end-of-line comment. |
+ * |
* @param tokens the tokens representing the comment |
* @return the end-of-line comment that was created |
*/ |
@@ -2690,6 +2983,7 @@ class Comment extends ASTNode { |
/** |
* Initialize a newly created comment. |
+ * |
* @param tokens the tokens representing the comment |
* @param type the type of the comment |
* @param references the references embedded within the documentation comment |
@@ -2703,6 +2997,7 @@ class Comment extends ASTNode { |
/** |
* Initialize a newly created comment. |
+ * |
* @param tokens the tokens representing the comment |
* @param type the type of the comment |
* @param references the references embedded within the documentation comment |
@@ -2714,30 +3009,35 @@ class Comment extends ASTNode { |
/** |
* Return the references embedded within the documentation comment. |
+ * |
* @return the references embedded within the documentation comment |
*/ |
NodeList<CommentReference> get references => _references; |
/** |
* Return the tokens representing the comment. |
+ * |
* @return the tokens representing the comment |
*/ |
List<Token> get tokens => _tokens; |
/** |
* Return `true` if this is a block comment. |
+ * |
* @return `true` if this is a block comment |
*/ |
bool get isBlock => identical(_type, CommentType.BLOCK); |
/** |
* Return `true` if this is a documentation comment. |
+ * |
* @return `true` if this is a documentation comment |
*/ |
bool get isDocumentation => identical(_type, CommentType.DOCUMENTATION); |
/** |
* Return `true` if this is an end-of-line comment. |
+ * |
* @return `true` if this is an end-of-line comment |
*/ |
bool get isEndOfLine => identical(_type, CommentType.END_OF_LINE); |
@@ -2781,10 +3081,12 @@ class CommentType implements Comparable<CommentType> { |
/** |
* Instances of the class `CommentReference` represent a reference to a Dart element that is |
* found within a documentation comment. |
+ * |
* <pre> |
* commentReference ::= |
- * '\[' 'new'? [Identifier identifier] '\]' |
+ * '[' 'new'? [Identifier] ']' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class CommentReference extends ASTNode { |
@@ -2801,6 +3103,7 @@ class CommentReference extends ASTNode { |
/** |
* Initialize a newly created reference to a Dart element. |
+ * |
* @param newKeyword the token representing the 'new' keyword |
* @param identifier the identifier being referenced |
*/ |
@@ -2811,6 +3114,7 @@ class CommentReference extends ASTNode { |
/** |
* Initialize a newly created reference to a Dart element. |
+ * |
* @param newKeyword the token representing the 'new' keyword |
* @param identifier the identifier being referenced |
*/ |
@@ -2821,18 +3125,21 @@ class CommentReference extends ASTNode { |
/** |
* Return the identifier being referenced. |
+ * |
* @return the identifier being referenced |
*/ |
Identifier get identifier => _identifier; |
/** |
* Return the token representing the 'new' keyword, or `null` if there was no 'new' keyword. |
+ * |
* @return the token representing the 'new' keyword |
*/ |
Token get newKeyword => _newKeyword; |
/** |
* Set the identifier being referenced to the given identifier. |
+ * |
* @param identifier the identifier being referenced |
*/ |
void set identifier(Identifier identifier2) { |
@@ -2841,6 +3148,7 @@ class CommentReference extends ASTNode { |
/** |
* Set the token representing the 'new' keyword to the given token. |
+ * |
* @param newKeyword the token representing the 'new' keyword |
*/ |
void set newKeyword(Token newKeyword2) { |
@@ -2857,10 +3165,23 @@ class CommentReference extends ASTNode { |
* unit, this class does not enforce those restrictions. In particular, the children of a |
* compilation unit will be visited in lexical order even if lexical order does not conform to the |
* restrictions of the grammar. |
+ * |
* <pre> |
* compilationUnit ::= |
- * directives declarations |
- * directives ::=[ScriptTag scriptTag]? [LibraryDirective libraryDirective]? namespaceDirective* [PartDirective partDirective]| [PartOfDirective partOfDirective]namespaceDirective ::=[ImportDirective importDirective]| [ExportDirective exportDirective]declarations ::=[CompilationUnitMember compilationUnitMember]</pre> |
+ * directives declarations |
+ * |
+ * directives ::= |
+ * [ScriptTag]? [LibraryDirective]? namespaceDirective* [PartDirective]* |
+ * | [PartOfDirective] |
+ * |
+ * namespaceDirective ::= |
+ * [ImportDirective] |
+ * | [ExportDirective] |
+ * |
+ * declarations ::= |
+ * [CompilationUnitMember]* |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class CompilationUnit extends ASTNode { |
@@ -2915,6 +3236,7 @@ class CompilationUnit extends ASTNode { |
/** |
* Initialize a newly created compilation unit to have the given directives and declarations. |
+ * |
* @param beginToken the first token in the token stream |
* @param scriptTag the script tag at the beginning of the compilation unit |
* @param directives the directives contained in this compilation unit |
@@ -2933,6 +3255,7 @@ class CompilationUnit extends ASTNode { |
/** |
* Initialize a newly created compilation unit to have the given directives and declarations. |
+ * |
* @param beginToken the first token in the token stream |
* @param scriptTag the script tag at the beginning of the compilation unit |
* @param directives the directives contained in this compilation unit |
@@ -2945,12 +3268,14 @@ class CompilationUnit extends ASTNode { |
/** |
* Return the declarations contained in this compilation unit. |
+ * |
* @return the declarations contained in this compilation unit |
*/ |
NodeList<CompilationUnitMember> get declarations => _declarations; |
/** |
* Return the directives contained in this compilation unit. |
+ * |
* @return the directives contained in this compilation unit |
*/ |
NodeList<Directive> get directives => _directives; |
@@ -2958,6 +3283,7 @@ class CompilationUnit extends ASTNode { |
/** |
* Return the element associated with this compilation unit, or `null` if the AST structure |
* has not been resolved. |
+ * |
* @return the element associated with this compilation unit |
*/ |
CompilationUnitElement get element => _element; |
@@ -2966,8 +3292,9 @@ class CompilationUnit extends ASTNode { |
/** |
* Return an array containing all of the errors associated with the receiver. If the receiver has |
* not been resolved, then return `null`. |
+ * |
* @return an array of errors (contains no `null`s) or `null` if the receiver has not |
- * been resolved |
+ * been resolved |
*/ |
List<AnalysisError> get errors { |
List<AnalysisError> parserErrors = parsingErrors; |
@@ -2993,6 +3320,7 @@ class CompilationUnit extends ASTNode { |
/** |
* Get the [LineInfo] object for this compilation unit. |
+ * |
* @return the associated [LineInfo] |
*/ |
LineInfo get lineInfo => _lineInfo; |
@@ -3000,6 +3328,7 @@ class CompilationUnit extends ASTNode { |
/** |
* Return an array containing all of the parsing errors associated with the receiver. |
+ * |
* @return an array of errors (not `null`, contains no `null`s). |
*/ |
List<AnalysisError> get parsingErrors => _parsingErrors; |
@@ -3007,20 +3336,23 @@ class CompilationUnit extends ASTNode { |
/** |
* Return an array containing all of the resolution errors associated with the receiver. If the |
* receiver has not been resolved, then return `null`. |
+ * |
* @return an array of errors (contains no `null`s) or `null` if the receiver has not |
- * been resolved |
+ * been resolved |
*/ |
List<AnalysisError> get resolutionErrors => _resolutionErrors; |
/** |
* Return the script tag at the beginning of the compilation unit, or `null` if there is no |
* script tag in this compilation unit. |
+ * |
* @return the script tag at the beginning of the compilation unit |
*/ |
ScriptTag get scriptTag => _scriptTag; |
/** |
* Set the element associated with this compilation unit to the given element. |
+ * |
* @param element the element associated with this compilation unit |
*/ |
void set element(CompilationUnitElement element2) { |
@@ -3029,6 +3361,7 @@ class CompilationUnit extends ASTNode { |
/** |
* Set the [LineInfo] object for this compilation unit. |
+ * |
* @param errors LineInfo to associate with this compilation unit |
*/ |
void set lineInfo(LineInfo lineInfo2) { |
@@ -3037,8 +3370,9 @@ class CompilationUnit extends ASTNode { |
/** |
* Called to cache the parsing errors when the unit is parsed. |
+ * |
* @param errors an array of parsing errors, if `null` is passed, the error array is set to |
- * an empty array, [AnalysisError#NO_ERRORS] |
+ * an empty array, [AnalysisError#NO_ERRORS] |
*/ |
void set parsingErrors(List<AnalysisError> errors) { |
_parsingErrors = errors == null ? AnalysisError.NO_ERRORS : errors; |
@@ -3046,8 +3380,9 @@ class CompilationUnit extends ASTNode { |
/** |
* Called to cache the resolution errors when the unit is resolved. |
+ * |
* @param errors an array of resolution errors, if `null` is passed, the error array is set |
- * to an empty array, [AnalysisError#NO_ERRORS] |
+ * to an empty array, [AnalysisError#NO_ERRORS] |
*/ |
void set resolutionErrors(List<AnalysisError> errors) { |
_resolutionErrors = errors == null ? AnalysisError.NO_ERRORS : errors; |
@@ -3055,6 +3390,7 @@ class CompilationUnit extends ASTNode { |
/** |
* Set the script tag at the beginning of the compilation unit to the given script tag. |
+ * |
* @param scriptTag the script tag at the beginning of the compilation unit |
*/ |
void set scriptTag(ScriptTag scriptTag2) { |
@@ -3074,6 +3410,7 @@ class CompilationUnit extends ASTNode { |
/** |
* Return `true` if all of the directives are lexically before any declarations. |
+ * |
* @return `true` if all of the directives are lexically before any declarations |
*/ |
bool directivesAreBeforeDeclarations() { |
@@ -3088,8 +3425,9 @@ class CompilationUnit extends ASTNode { |
/** |
* Return an array containing all of the directives and declarations in this compilation unit, |
* sorted in lexical order. |
+ * |
* @return the directives and declarations in this compilation unit in the order in which they |
- * appeared in the original source |
+ * appeared in the original source |
*/ |
List<ASTNode> get sortedDirectivesAndDeclarations { |
List<ASTNode> childList = new List<ASTNode>(); |
@@ -3103,14 +3441,24 @@ class CompilationUnit extends ASTNode { |
/** |
* Instances of the class `CompilationUnitMember` defines the behavior common to nodes that |
* declare a name within the scope of a compilation unit. |
+ * |
* <pre> |
- * compilationUnitMember ::=[ClassDeclaration classDeclaration]| [TypeAlias typeAlias]| [FunctionDeclaration functionDeclaration]| [MethodDeclaration getOrSetDeclaration]| [VariableDeclaration constantsDeclaration]| [VariableDeclaration variablesDeclaration]</pre> |
+ * compilationUnitMember ::= |
+ * [ClassDeclaration] |
+ * | [TypeAlias] |
+ * | [FunctionDeclaration] |
+ * | [MethodDeclaration] |
+ * | [VariableDeclaration] |
+ * | [VariableDeclaration] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class CompilationUnitMember extends Declaration { |
/** |
* Initialize a newly created generic compilation unit member. |
+ * |
* @param comment the documentation comment associated with this member |
* @param metadata the annotations associated with this member |
*/ |
@@ -3119,6 +3467,7 @@ abstract class CompilationUnitMember extends Declaration { |
/** |
* Initialize a newly created generic compilation unit member. |
+ * |
* @param comment the documentation comment associated with this member |
* @param metadata the annotations associated with this member |
*/ |
@@ -3126,8 +3475,12 @@ abstract class CompilationUnitMember extends Declaration { |
} |
/** |
* Instances of the class `ConditionalExpression` represent a conditional expression. |
+ * |
* <pre> |
- * conditionalExpression ::=[Expression condition] '?' [Expression thenExpression] ':' [Expression elseExpression]</pre> |
+ * conditionalExpression ::= |
+ * [Expression] '?' [Expression] ':' [Expression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ConditionalExpression extends Expression { |
@@ -3159,11 +3512,14 @@ class ConditionalExpression extends Expression { |
/** |
* Initialize a newly created conditional expression. |
+ * |
* @param condition the condition used to determine which expression is executed next |
* @param question the token used to separate the condition from the then expression |
- * @param thenExpression the expression that is executed if the condition evaluates to`true` |
+ * @param thenExpression the expression that is executed if the condition evaluates to |
+ * `true` |
* @param colon the token used to separate the then expression from the else expression |
- * @param elseExpression the expression that is executed if the condition evaluates to`false` |
+ * @param elseExpression the expression that is executed if the condition evaluates to |
+ * `false` |
*/ |
ConditionalExpression.full(Expression condition, Token question, Expression thenExpression, Token colon, Expression elseExpression) { |
this._condition = becomeParentOf(condition); |
@@ -3175,11 +3531,14 @@ class ConditionalExpression extends Expression { |
/** |
* Initialize a newly created conditional expression. |
+ * |
* @param condition the condition used to determine which expression is executed next |
* @param question the token used to separate the condition from the then expression |
- * @param thenExpression the expression that is executed if the condition evaluates to`true` |
+ * @param thenExpression the expression that is executed if the condition evaluates to |
+ * `true` |
* @param colon the token used to separate the then expression from the else expression |
- * @param elseExpression the expression that is executed if the condition evaluates to`false` |
+ * @param elseExpression the expression that is executed if the condition evaluates to |
+ * `false` |
*/ |
ConditionalExpression({Expression condition, Token question, Expression thenExpression, Token colon, Expression elseExpression}) : this.full(condition, question, thenExpression, colon, elseExpression); |
accept(ASTVisitor visitor) => visitor.visitConditionalExpression(this); |
@@ -3187,18 +3546,21 @@ class ConditionalExpression extends Expression { |
/** |
* Return the token used to separate the then expression from the else expression. |
+ * |
* @return the token used to separate the then expression from the else expression |
*/ |
Token get colon => _colon; |
/** |
* Return the condition used to determine which of the expressions is executed next. |
+ * |
* @return the condition used to determine which expression is executed next |
*/ |
Expression get condition => _condition; |
/** |
* Return the expression that is executed if the condition evaluates to `false`. |
+ * |
* @return the expression that is executed if the condition evaluates to `false` |
*/ |
Expression get elseExpression => _elseExpression; |
@@ -3206,18 +3568,21 @@ class ConditionalExpression extends Expression { |
/** |
* Return the token used to separate the condition from the then expression. |
+ * |
* @return the token used to separate the condition from the then expression |
*/ |
Token get question => _question; |
/** |
* Return the expression that is executed if the condition evaluates to `true`. |
+ * |
* @return the expression that is executed if the condition evaluates to `true` |
*/ |
Expression get thenExpression => _thenExpression; |
/** |
* Set the token used to separate the then expression from the else expression to the given token. |
+ * |
* @param colon the token used to separate the then expression from the else expression |
*/ |
void set colon(Token colon2) { |
@@ -3227,6 +3592,7 @@ class ConditionalExpression extends Expression { |
/** |
* Set the condition used to determine which of the expressions is executed next to the given |
* expression. |
+ * |
* @param expression the condition used to determine which expression is executed next |
*/ |
void set condition(Expression expression) { |
@@ -3236,6 +3602,7 @@ class ConditionalExpression extends Expression { |
/** |
* Set the expression that is executed if the condition evaluates to `false` to the given |
* expression. |
+ * |
* @param expression the expression that is executed if the condition evaluates to `false` |
*/ |
void set elseExpression(Expression expression) { |
@@ -3244,6 +3611,7 @@ class ConditionalExpression extends Expression { |
/** |
* Set the token used to separate the condition from the then expression to the given token. |
+ * |
* @param question the token used to separate the condition from the then expression |
*/ |
void set question(Token question2) { |
@@ -3253,6 +3621,7 @@ class ConditionalExpression extends Expression { |
/** |
* Set the expression that is executed if the condition evaluates to `true` to the given |
* expression. |
+ * |
* @param expression the expression that is executed if the condition evaluates to `true` |
*/ |
void set thenExpression(Expression expression) { |
@@ -3266,19 +3635,27 @@ class ConditionalExpression extends Expression { |
} |
/** |
* Instances of the class `ConstructorDeclaration` represent a constructor declaration. |
+ * |
* <pre> |
* constructorDeclaration ::= |
- * constructorSignature [FunctionBody body]? |
- * | constructorName formalParameterList ':' 'this' ('.' [SimpleIdentifier name])? arguments |
+ * constructorSignature [FunctionBody]? |
+ * | constructorName formalParameterList ':' 'this' ('.' [SimpleIdentifier])? arguments |
+ * |
* constructorSignature ::= |
- * 'external'? constructorName formalParameterList initializerList? |
- * | 'external'? 'factory' factoryName formalParameterList initializerList? |
- * | 'external'? 'const' constructorName formalParameterList initializerList? |
- * constructorName ::=[SimpleIdentifier returnType] ('.' [SimpleIdentifier name])? |
- * factoryName ::=[Identifier returnType] ('.' [SimpleIdentifier name])? |
+ * 'external'? constructorName formalParameterList initializerList? |
+ * | 'external'? 'factory' factoryName formalParameterList initializerList? |
+ * | 'external'? 'const' constructorName formalParameterList initializerList? |
+ * |
+ * constructorName ::= |
+ * [SimpleIdentifier] ('.' [SimpleIdentifier])? |
+ * |
+ * factoryName ::= |
+ * [Identifier] ('.' [SimpleIdentifier])? |
+ * |
* initializerList ::= |
- * ':' [ConstructorInitializer initializer] (',' [ConstructorInitializer initializer]) |
+ * ':' [ConstructorInitializer] (',' [ConstructorInitializer])* |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ConstructorDeclaration extends ClassMember { |
@@ -3352,6 +3729,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Initialize a newly created constructor declaration. |
+ * |
* @param externalKeyword the token for the 'external' keyword |
* @param comment the documentation comment associated with this constructor |
* @param metadata the annotations associated with this constructor |
@@ -3364,7 +3742,7 @@ class ConstructorDeclaration extends ClassMember { |
* @param separator the token for the colon or equals before the initializers |
* @param initializers the initializers associated with the constructor |
* @param redirectedConstructor the name of the constructor to which this constructor will be |
- * redirected |
+ * redirected |
* @param body the body of the constructor |
*/ |
ConstructorDeclaration.full(Comment comment, List<Annotation> metadata, Token externalKeyword, Token constKeyword, Token factoryKeyword, Identifier returnType, Token period, SimpleIdentifier name, FormalParameterList parameters, Token separator, List<ConstructorInitializer> initializers, ConstructorName redirectedConstructor, FunctionBody body) : super.full(comment, metadata) { |
@@ -3384,6 +3762,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Initialize a newly created constructor declaration. |
+ * |
* @param externalKeyword the token for the 'external' keyword |
* @param comment the documentation comment associated with this constructor |
* @param metadata the annotations associated with this constructor |
@@ -3396,7 +3775,7 @@ class ConstructorDeclaration extends ClassMember { |
* @param separator the token for the colon or equals before the initializers |
* @param initializers the initializers associated with the constructor |
* @param redirectedConstructor the name of the constructor to which this constructor will be |
- * redirected |
+ * redirected |
* @param body the body of the constructor |
*/ |
ConstructorDeclaration({Comment comment, List<Annotation> metadata, Token externalKeyword, Token constKeyword, Token factoryKeyword, Identifier returnType, Token period, SimpleIdentifier name, FormalParameterList parameters, Token separator, List<ConstructorInitializer> initializers, ConstructorName redirectedConstructor, FunctionBody body}) : this.full(comment, metadata, externalKeyword, constKeyword, factoryKeyword, returnType, period, name, parameters, separator, initializers, redirectedConstructor, body); |
@@ -3404,12 +3783,14 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Return the body of the constructor, or `null` if the constructor does not have a body. |
+ * |
* @return the body of the constructor |
*/ |
FunctionBody get body => _body; |
/** |
* Return the token for the 'const' keyword. |
+ * |
* @return the token for the 'const' keyword |
*/ |
Token get constKeyword => _constKeyword; |
@@ -3426,18 +3807,21 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Return the token for the 'external' keyword, or `null` if the constructor is not |
* external. |
+ * |
* @return the token for the 'external' keyword |
*/ |
Token get externalKeyword => _externalKeyword; |
/** |
* Return the token for the 'factory' keyword. |
+ * |
* @return the token for the 'factory' keyword |
*/ |
Token get factoryKeyword => _factoryKeyword; |
/** |
* Return the initializers associated with the constructor. |
+ * |
* @return the initializers associated with the constructor |
*/ |
NodeList<ConstructorInitializer> get initializers => _initializers; |
@@ -3445,12 +3829,14 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Return the name of the constructor, or `null` if the constructor being declared is |
* unnamed. |
+ * |
* @return the name of the constructor |
*/ |
SimpleIdentifier get name => _name; |
/** |
* Return the parameters associated with the constructor. |
+ * |
* @return the parameters associated with the constructor |
*/ |
FormalParameterList get parameters => _parameters; |
@@ -3458,12 +3844,15 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Return the token for the period before the constructor name, or `null` if the constructor |
* being declared is unnamed. |
+ * |
* @return the token for the period before the constructor name |
*/ |
Token get period => _period; |
/** |
- * Return the name of the constructor to which this constructor will be redirected, or`null` if this is not a redirecting factory constructor. |
+ * Return the name of the constructor to which this constructor will be redirected, or |
+ * `null` if this is not a redirecting factory constructor. |
+ * |
* @return the name of the constructor to which this constructor will be redirected |
*/ |
ConstructorName get redirectedConstructor => _redirectedConstructor; |
@@ -3472,18 +3861,22 @@ class ConstructorDeclaration extends ClassMember { |
* Return the type of object being created. This can be different than the type in which the |
* constructor is being declared if the constructor is the implementation of a factory |
* constructor. |
+ * |
* @return the type of object being created |
*/ |
Identifier get returnType => _returnType; |
/** |
- * Return the token for the separator (colon or equals) before the initializers, or `null`if there are no initializers. |
+ * Return the token for the separator (colon or equals) before the initializers, or `null` |
+ * if there are no initializers. |
+ * |
* @return the token for the separator (colon or equals) before the initializers |
*/ |
Token get separator => _separator; |
/** |
* Set the body of the constructor to the given function body. |
+ * |
* @param functionBody the body of the constructor |
*/ |
void set body(FunctionBody functionBody) { |
@@ -3492,6 +3885,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the token for the 'const' keyword to the given token. |
+ * |
* @param constKeyword the token for the 'const' keyword |
*/ |
void set constKeyword(Token constKeyword2) { |
@@ -3500,6 +3894,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the element associated with this constructor to the given element. |
+ * |
* @param element the element associated with this constructor |
*/ |
void set element(ConstructorElement element2) { |
@@ -3508,6 +3903,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the token for the 'external' keyword to the given token. |
+ * |
* @param externalKeyword the token for the 'external' keyword |
*/ |
void set externalKeyword(Token externalKeyword2) { |
@@ -3516,6 +3912,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the token for the 'factory' keyword to the given token. |
+ * |
* @param factoryKeyword the token for the 'factory' keyword |
*/ |
void set factoryKeyword(Token factoryKeyword2) { |
@@ -3524,6 +3921,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the name of the constructor to the given identifier. |
+ * |
* @param identifier the name of the constructor |
*/ |
void set name(SimpleIdentifier identifier) { |
@@ -3532,6 +3930,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the parameters associated with the constructor to the given list of parameters. |
+ * |
* @param parameters the parameters associated with the constructor |
*/ |
void set parameters(FormalParameterList parameters2) { |
@@ -3540,6 +3939,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the token for the period before the constructor name to the given token. |
+ * |
* @param period the token for the period before the constructor name |
*/ |
void set period(Token period2) { |
@@ -3549,8 +3949,9 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the name of the constructor to which this constructor will be redirected to the given |
* constructor name. |
+ * |
* @param redirectedConstructor the name of the constructor to which this constructor will be |
- * redirected |
+ * redirected |
*/ |
void set redirectedConstructor(ConstructorName redirectedConstructor2) { |
this._redirectedConstructor = becomeParentOf(redirectedConstructor2); |
@@ -3558,6 +3959,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the type of object being created to the given type name. |
+ * |
* @param typeName the type of object being created |
*/ |
void set returnType(Identifier typeName) { |
@@ -3566,6 +3968,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Set the token for the separator (colon or equals) before the initializers to the given token. |
+ * |
* @param separator the token for the separator (colon or equals) before the initializers |
*/ |
void set separator(Token separator2) { |
@@ -3591,6 +3994,7 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Return the left-most of the given tokens, or `null` if there are no tokens given or if |
* all of the given tokens are `null`. |
+ * |
* @param tokens the tokens being compared to find the left-most token |
* @return the left-most of the given tokens |
*/ |
@@ -3608,9 +4012,12 @@ class ConstructorDeclaration extends ClassMember { |
/** |
* Instances of the class `ConstructorFieldInitializer` represent the initialization of a |
* field within a constructor's initialization list. |
+ * |
* <pre> |
* fieldInitializer ::= |
- * ('this' '.')? [SimpleIdentifier fieldName] '=' [Expression conditionalExpression cascadeSection*]</pre> |
+ * ('this' '.')? [SimpleIdentifier] '=' [Expression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ConstructorFieldInitializer extends ConstructorInitializer { |
@@ -3644,6 +4051,7 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Initialize a newly created field initializer to initialize the field with the given name to the |
* value of the given expression. |
+ * |
* @param keyword the token for the 'this' keyword |
* @param period the token for the period after the 'this' keyword |
* @param fieldName the name of the field being initialized |
@@ -3661,6 +4069,7 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Initialize a newly created field initializer to initialize the field with the given name to the |
* value of the given expression. |
+ * |
* @param keyword the token for the 'this' keyword |
* @param period the token for the period after the 'this' keyword |
* @param fieldName the name of the field being initialized |
@@ -3679,24 +4088,28 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Return the token for the equal sign between the field name and the expression. |
+ * |
* @return the token for the equal sign between the field name and the expression |
*/ |
Token get equals => _equals; |
/** |
* Return the expression computing the value to which the field will be initialized. |
+ * |
* @return the expression computing the value to which the field will be initialized |
*/ |
Expression get expression => _expression; |
/** |
* Return the name of the field being initialized. |
+ * |
* @return the name of the field being initialized |
*/ |
SimpleIdentifier get fieldName => _fieldName; |
/** |
* Return the token for the 'this' keyword, or `null` if there is no 'this' keyword. |
+ * |
* @return the token for the 'this' keyword |
*/ |
Token get keyword => _keyword; |
@@ -3704,12 +4117,14 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Return the token for the period after the 'this' keyword, or `null` if there is no 'this' |
* keyword. |
+ * |
* @return the token for the period after the 'this' keyword |
*/ |
Token get period => _period; |
/** |
* Set the token for the equal sign between the field name and the expression to the given token. |
+ * |
* @param equals the token for the equal sign between the field name and the expression |
*/ |
void set equals(Token equals2) { |
@@ -3719,6 +4134,7 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Set the expression computing the value to which the field will be initialized to the given |
* expression. |
+ * |
* @param expression the expression computing the value to which the field will be initialized |
*/ |
void set expression(Expression expression2) { |
@@ -3727,6 +4143,7 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Set the name of the field being initialized to the given identifier. |
+ * |
* @param identifier the name of the field being initialized |
*/ |
void set fieldName(SimpleIdentifier identifier) { |
@@ -3735,6 +4152,7 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Set the token for the 'this' keyword to the given token. |
+ * |
* @param keyword the token for the 'this' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -3743,6 +4161,7 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Set the token for the period after the 'this' keyword to the given token. |
+ * |
* @param period the token for the period after the 'this' keyword |
*/ |
void set period(Token period2) { |
@@ -3756,18 +4175,25 @@ class ConstructorFieldInitializer extends ConstructorInitializer { |
/** |
* Instances of the class `ConstructorInitializer` defines the behavior of nodes that can |
* occur in the initializer list of a constructor declaration. |
+ * |
* <pre> |
- * constructorInitializer ::=[SuperConstructorInvocation superInvocation]| [ConstructorFieldInitializer fieldInitializer]</pre> |
+ * constructorInitializer ::= |
+ * [SuperConstructorInvocation] |
+ * | [ConstructorFieldInitializer] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class ConstructorInitializer extends ASTNode { |
} |
/** |
* Instances of the class `ConstructorName` represent the name of the constructor. |
+ * |
* <pre> |
* constructorName: |
- * type ('.' identifier)? |
+ * type ('.' identifier)? |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ConstructorName extends ASTNode { |
@@ -3790,19 +4216,22 @@ class ConstructorName extends ASTNode { |
SimpleIdentifier _name; |
/** |
- * The element associated with this constructor name based on static type information, or`null` if the AST structure has not been resolved or if this constructor name could not |
+ * The element associated with this constructor name based on static type information, or |
+ * `null` if the AST structure has not been resolved or if this constructor name could not |
* be resolved. |
*/ |
ConstructorElement _staticElement; |
/** |
- * The element associated with this constructor name based on propagated type information, or`null` if the AST structure has not been resolved or if this constructor name could not |
+ * The element associated with this constructor name based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or if this constructor name could not |
* be resolved. |
*/ |
ConstructorElement _propagatedElement; |
/** |
* Initialize a newly created constructor name. |
+ * |
* @param type the name of the type defining the constructor |
* @param period the token for the period before the constructor name |
* @param name the name of the constructor |
@@ -3815,6 +4244,7 @@ class ConstructorName extends ASTNode { |
/** |
* Initialize a newly created constructor name. |
+ * |
* @param type the name of the type defining the constructor |
* @param period the token for the period before the constructor name |
* @param name the name of the constructor |
@@ -3827,6 +4257,7 @@ class ConstructorName extends ASTNode { |
* Return the element associated with this constructor name based on propagated type information, |
* or `null` if the AST structure has not been resolved or if this constructor name could |
* not be resolved. |
+ * |
* @return the element associated with this constructor name |
*/ |
ConstructorElement get element => _propagatedElement; |
@@ -3840,6 +4271,7 @@ class ConstructorName extends ASTNode { |
/** |
* Return the name of the constructor, or `null` if the specified constructor is the unnamed |
* constructor. |
+ * |
* @return the name of the constructor |
*/ |
SimpleIdentifier get name => _name; |
@@ -3847,19 +4279,23 @@ class ConstructorName extends ASTNode { |
/** |
* Return the token for the period before the constructor name, or `null` if the specified |
* constructor is the unnamed constructor. |
+ * |
* @return the token for the period before the constructor name |
*/ |
Token get period => _period; |
/** |
- * Return the element associated with this constructor name based on static type information, or`null` if the AST structure has not been resolved or if this constructor name could not |
+ * Return the element associated with this constructor name based on static type information, or |
+ * `null` if the AST structure has not been resolved or if this constructor name could not |
* be resolved. |
+ * |
* @return the element associated with this constructor name |
*/ |
ConstructorElement get staticElement => _staticElement; |
/** |
* Return the name of the type defining the constructor. |
+ * |
* @return the name of the type defining the constructor |
*/ |
TypeName get type => _type; |
@@ -3867,6 +4303,7 @@ class ConstructorName extends ASTNode { |
/** |
* Set the element associated with this constructor name based on propagated type information to |
* the given element. |
+ * |
* @param element the element to be associated with this constructor name |
*/ |
void set element(ConstructorElement element2) { |
@@ -3875,6 +4312,7 @@ class ConstructorName extends ASTNode { |
/** |
* Set the name of the constructor to the given name. |
+ * |
* @param name the name of the constructor |
*/ |
void set name(SimpleIdentifier name2) { |
@@ -3883,6 +4321,7 @@ class ConstructorName extends ASTNode { |
/** |
* Return the token for the period before the constructor name to the given token. |
+ * |
* @param period the token for the period before the constructor name |
*/ |
void set period(Token period2) { |
@@ -3892,6 +4331,7 @@ class ConstructorName extends ASTNode { |
/** |
* Set the element associated with this constructor name based on static type information to the |
* given element. |
+ * |
* @param element the element to be associated with this constructor name |
*/ |
void set staticElement(ConstructorElement element) { |
@@ -3900,6 +4340,7 @@ class ConstructorName extends ASTNode { |
/** |
* Set the name of the type defining the constructor to the given type name. |
+ * |
* @param type the name of the type defining the constructor |
*/ |
void set type(TypeName type2) { |
@@ -3912,10 +4353,12 @@ class ConstructorName extends ASTNode { |
} |
/** |
* Instances of the class `ContinueStatement` represent a continue statement. |
+ * |
* <pre> |
* continueStatement ::= |
- * 'continue' [SimpleIdentifier label]? ';' |
+ * 'continue' [SimpleIdentifier]? ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ContinueStatement extends Statement { |
@@ -3937,6 +4380,7 @@ class ContinueStatement extends Statement { |
/** |
* Initialize a newly created continue statement. |
+ * |
* @param keyword the token representing the 'continue' keyword |
* @param label the label associated with the statement |
* @param semicolon the semicolon terminating the statement |
@@ -3949,6 +4393,7 @@ class ContinueStatement extends Statement { |
/** |
* Initialize a newly created continue statement. |
+ * |
* @param keyword the token representing the 'continue' keyword |
* @param label the label associated with the statement |
* @param semicolon the semicolon terminating the statement |
@@ -3960,24 +4405,28 @@ class ContinueStatement extends Statement { |
/** |
* Return the token representing the 'continue' keyword. |
+ * |
* @return the token representing the 'continue' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the label associated with the statement, or `null` if there is no label. |
+ * |
* @return the label associated with the statement |
*/ |
SimpleIdentifier get label => _label; |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the token representing the 'continue' keyword to the given token. |
+ * |
* @param keyword the token representing the 'continue' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -3986,6 +4435,7 @@ class ContinueStatement extends Statement { |
/** |
* Set the label associated with the statement to the given label. |
+ * |
* @param identifier the label associated with the statement |
*/ |
void set label(SimpleIdentifier identifier) { |
@@ -3994,6 +4444,7 @@ class ContinueStatement extends Statement { |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -4006,12 +4457,14 @@ class ContinueStatement extends Statement { |
/** |
* The abstract class `Declaration` defines the behavior common to nodes that represent the |
* declaration of a name. Each declared name is visible within a name scope. |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class Declaration extends AnnotatedNode { |
/** |
* Initialize a newly created declaration. |
+ * |
* @param comment the documentation comment associated with this declaration |
* @param metadata the annotations associated with this declaration |
*/ |
@@ -4020,6 +4473,7 @@ abstract class Declaration extends AnnotatedNode { |
/** |
* Initialize a newly created declaration. |
+ * |
* @param comment the documentation comment associated with this declaration |
* @param metadata the annotations associated with this declaration |
*/ |
@@ -4028,6 +4482,7 @@ abstract class Declaration extends AnnotatedNode { |
/** |
* Return the element associated with this declaration, or `null` if either this node |
* corresponds to a list of declarations or if the AST structure has not been resolved. |
+ * |
* @return the element associated with this declaration |
*/ |
Element get element; |
@@ -4035,9 +4490,12 @@ abstract class Declaration extends AnnotatedNode { |
/** |
* Instances of the class `DeclaredIdentifier` represent the declaration of a single |
* identifier. |
+ * |
* <pre> |
* declaredIdentifier ::= |
- * ([Annotation metadata] finalConstVarOrType [SimpleIdentifier identifier]</pre> |
+ * ([Annotation] finalConstVarOrType [SimpleIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class DeclaredIdentifier extends Declaration { |
@@ -4061,6 +4519,7 @@ class DeclaredIdentifier extends Declaration { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
@@ -4075,6 +4534,7 @@ class DeclaredIdentifier extends Declaration { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
@@ -4094,12 +4554,14 @@ class DeclaredIdentifier extends Declaration { |
/** |
* Return the name of the variable being declared. |
+ * |
* @return the name of the variable being declared |
*/ |
SimpleIdentifier get identifier => _identifier; |
/** |
* Return the token representing either the 'final', 'const' or 'var' keyword. |
+ * |
* @return the token representing either the 'final', 'const' or 'var' keyword |
*/ |
Token get keyword => _keyword; |
@@ -4107,12 +4569,14 @@ class DeclaredIdentifier extends Declaration { |
/** |
* Return the name of the declared type of the parameter, or `null` if the parameter does |
* not have a declared type. |
+ * |
* @return the name of the declared type of the parameter |
*/ |
TypeName get type => _type; |
/** |
* Return `true` if this variable was declared with the 'const' modifier. |
+ * |
* @return `true` if this variable was declared with the 'const' modifier |
*/ |
bool get isConst => (_keyword is KeywordToken) && identical(((_keyword as KeywordToken)).keyword, Keyword.CONST); |
@@ -4121,12 +4585,14 @@ class DeclaredIdentifier extends Declaration { |
* Return `true` if this variable was declared with the 'final' modifier. Variables that are |
* declared with the 'const' modifier will return `false` even though they are implicitly |
* final. |
+ * |
* @return `true` if this variable was declared with the 'final' modifier |
*/ |
bool get isFinal => (_keyword is KeywordToken) && identical(((_keyword as KeywordToken)).keyword, Keyword.FINAL); |
/** |
* Set the token representing either the 'final', 'const' or 'var' keyword to the given token. |
+ * |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -4135,6 +4601,7 @@ class DeclaredIdentifier extends Declaration { |
/** |
* Set the name of the declared type of the parameter to the given type name. |
+ * |
* @param typeName the name of the declared type of the parameter |
*/ |
void set type(TypeName typeName) { |
@@ -4158,10 +4625,15 @@ class DeclaredIdentifier extends Declaration { |
* Instances of the class `DefaultFormalParameter` represent a formal parameter with a default |
* value. There are two kinds of parameters that are both represented by this class: named formal |
* parameters and positional formal parameters. |
+ * |
* <pre> |
- * defaultFormalParameter ::=[NormalFormalParameter normalFormalParameter] ('=' [Expression defaultValue])? |
- * defaultNamedParameter ::=[NormalFormalParameter normalFormalParameter] (':' [Expression defaultValue])? |
+ * defaultFormalParameter ::= |
+ * [NormalFormalParameter] ('=' [Expression])? |
+ * |
+ * defaultNamedParameter ::= |
+ * [NormalFormalParameter] (':' [Expression])? |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class DefaultFormalParameter extends FormalParameter { |
@@ -4190,6 +4662,7 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* Initialize a newly created default formal parameter. |
+ * |
* @param parameter the formal parameter with which the default value is associated |
* @param kind the kind of this parameter |
* @param separator the token separating the parameter from the default value |
@@ -4204,6 +4677,7 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* Initialize a newly created default formal parameter. |
+ * |
* @param parameter the formal parameter with which the default value is associated |
* @param kind the kind of this parameter |
* @param separator the token separating the parameter from the default value |
@@ -4216,6 +4690,7 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* Return the expression computing the default value for the parameter, or `null` if there |
* is no default value. |
+ * |
* @return the expression computing the default value for the parameter |
*/ |
Expression get defaultValue => _defaultValue; |
@@ -4230,6 +4705,7 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* Return the formal parameter with which the default value is associated. |
+ * |
* @return the formal parameter with which the default value is associated |
*/ |
NormalFormalParameter get parameter => _parameter; |
@@ -4237,12 +4713,14 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* Return the token separating the parameter from the default value, or `null` if there is |
* no default value. |
+ * |
* @return the token separating the parameter from the default value |
*/ |
Token get separator => _separator; |
/** |
* Return `true` if this parameter was declared with the 'const' modifier. |
+ * |
* @return `true` if this parameter was declared with the 'const' modifier |
*/ |
bool get isConst => _parameter != null && _parameter.isConst; |
@@ -4251,12 +4729,14 @@ class DefaultFormalParameter extends FormalParameter { |
* Return `true` if this parameter was declared with the 'final' modifier. Parameters that |
* are declared with the 'const' modifier will return `false` even though they are |
* implicitly final. |
+ * |
* @return `true` if this parameter was declared with the 'final' modifier |
*/ |
bool get isFinal => _parameter != null && _parameter.isFinal; |
/** |
* Set the expression computing the default value for the parameter to the given expression. |
+ * |
* @param expression the expression computing the default value for the parameter |
*/ |
void set defaultValue(Expression expression) { |
@@ -4265,6 +4745,7 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* Set the kind of this parameter to the given kind. |
+ * |
* @param kind the kind of this parameter |
*/ |
void set kind(ParameterKind kind2) { |
@@ -4273,6 +4754,7 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* Set the formal parameter with which the default value is associated to the given parameter. |
+ * |
* @param formalParameter the formal parameter with which the default value is associated |
*/ |
void set parameter(NormalFormalParameter formalParameter) { |
@@ -4281,6 +4763,7 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* Set the token separating the parameter from the default value to the given token. |
+ * |
* @param separator the token separating the parameter from the default value |
*/ |
void set separator(Token separator2) { |
@@ -4294,8 +4777,16 @@ class DefaultFormalParameter extends FormalParameter { |
/** |
* The abstract class `Directive` defines the behavior common to nodes that represent a |
* directive. |
+ * |
* <pre> |
- * directive ::=[ExportDirective exportDirective]| [ImportDirective importDirective]| [LibraryDirective libraryDirective]| [PartDirective partDirective]| [PartOfDirective partOfDirective]</pre> |
+ * directive ::= |
+ * [ExportDirective] |
+ * | [ImportDirective] |
+ * | [LibraryDirective] |
+ * | [PartDirective] |
+ * | [PartOfDirective] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class Directive extends AnnotatedNode { |
@@ -4308,6 +4799,7 @@ abstract class Directive extends AnnotatedNode { |
/** |
* Initialize a newly create directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
*/ |
@@ -4316,6 +4808,7 @@ abstract class Directive extends AnnotatedNode { |
/** |
* Initialize a newly create directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
*/ |
@@ -4325,6 +4818,7 @@ abstract class Directive extends AnnotatedNode { |
* Return the element associated with this directive, or `null` if the AST structure has not |
* been resolved or if this directive could not be resolved. Examples of the latter case include a |
* directive that contains an invalid URL or a URL that does not exist. |
+ * |
* @return the element associated with this directive |
*/ |
Element get element => _element; |
@@ -4332,12 +4826,14 @@ abstract class Directive extends AnnotatedNode { |
/** |
* Return the token representing the keyword that introduces this directive ('import', 'export', |
* 'library' or 'part'). |
+ * |
* @return the token representing the keyword that introduces this directive |
*/ |
Token get keyword; |
/** |
* Set the element associated with this directive to the given element. |
+ * |
* @param element the element associated with this directive |
*/ |
void set element(Element element2) { |
@@ -4346,10 +4842,12 @@ abstract class Directive extends AnnotatedNode { |
} |
/** |
* Instances of the class `DoStatement` represent a do statement. |
+ * |
* <pre> |
* doStatement ::= |
- * 'do' [Statement body] 'while' '(' [Expression condition] ')' ';' |
+ * 'do' [Statement] 'while' '(' [Expression] ')' ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class DoStatement extends Statement { |
@@ -4391,6 +4889,7 @@ class DoStatement extends Statement { |
/** |
* Initialize a newly created do loop. |
+ * |
* @param doKeyword the token representing the 'do' keyword |
* @param body the body of the loop |
* @param whileKeyword the token representing the 'while' keyword |
@@ -4411,6 +4910,7 @@ class DoStatement extends Statement { |
/** |
* Initialize a newly created do loop. |
+ * |
* @param doKeyword the token representing the 'do' keyword |
* @param body the body of the loop |
* @param whileKeyword the token representing the 'while' keyword |
@@ -4425,18 +4925,21 @@ class DoStatement extends Statement { |
/** |
* Return the body of the loop. |
+ * |
* @return the body of the loop |
*/ |
Statement get body => _body; |
/** |
* Return the condition that determines when the loop will terminate. |
+ * |
* @return the condition that determines when the loop will terminate |
*/ |
Expression get condition => _condition; |
/** |
* Return the token representing the 'do' keyword. |
+ * |
* @return the token representing the 'do' keyword |
*/ |
Token get doKeyword => _doKeyword; |
@@ -4444,30 +4947,35 @@ class DoStatement extends Statement { |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
/** |
* Return the token representing the 'while' keyword. |
+ * |
* @return the token representing the 'while' keyword |
*/ |
Token get whileKeyword => _whileKeyword; |
/** |
* Set the body of the loop to the given statement. |
+ * |
* @param statement the body of the loop |
*/ |
void set body(Statement statement) { |
@@ -4476,6 +4984,7 @@ class DoStatement extends Statement { |
/** |
* Set the condition that determines when the loop will terminate to the given expression. |
+ * |
* @param expression the condition that determines when the loop will terminate |
*/ |
void set condition(Expression expression) { |
@@ -4484,6 +4993,7 @@ class DoStatement extends Statement { |
/** |
* Set the token representing the 'do' keyword to the given token. |
+ * |
* @param doKeyword the token representing the 'do' keyword |
*/ |
void set doKeyword(Token doKeyword2) { |
@@ -4492,6 +5002,7 @@ class DoStatement extends Statement { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param parenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token parenthesis) { |
@@ -4500,6 +5011,7 @@ class DoStatement extends Statement { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param parenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token parenthesis) { |
@@ -4508,6 +5020,7 @@ class DoStatement extends Statement { |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -4516,6 +5029,7 @@ class DoStatement extends Statement { |
/** |
* Set the token representing the 'while' keyword to the given token. |
+ * |
* @param whileKeyword the token representing the 'while' keyword |
*/ |
void set whileKeyword(Token whileKeyword2) { |
@@ -4528,13 +5042,16 @@ class DoStatement extends Statement { |
} |
/** |
* Instances of the class `DoubleLiteral` represent a floating point literal expression. |
+ * |
* <pre> |
* doubleLiteral ::= |
- * decimalDigit+ ('.' decimalDigit*)? exponent? |
- * | '.' decimalDigit+ exponent? |
+ * decimalDigit+ ('.' decimalDigit*)? exponent? |
+ * | '.' decimalDigit+ exponent? |
+ * |
* exponent ::= |
- * ('e' | 'E') ('+' | '-')? decimalDigit+ |
+ * ('e' | 'E') ('+' | '-')? decimalDigit+ |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class DoubleLiteral extends Literal { |
@@ -4551,6 +5068,7 @@ class DoubleLiteral extends Literal { |
/** |
* Initialize a newly created floating point literal. |
+ * |
* @param literal the token representing the literal |
* @param value the value of the literal |
*/ |
@@ -4561,6 +5079,7 @@ class DoubleLiteral extends Literal { |
/** |
* Initialize a newly created floating point literal. |
+ * |
* @param literal the token representing the literal |
* @param value the value of the literal |
*/ |
@@ -4571,18 +5090,21 @@ class DoubleLiteral extends Literal { |
/** |
* Return the token representing the literal. |
+ * |
* @return the token representing the literal |
*/ |
Token get literal => _literal; |
/** |
* Return the value of the literal. |
+ * |
* @return the value of the literal |
*/ |
double get value => _value; |
/** |
* Set the token representing the literal to the given token. |
+ * |
* @param literal the token representing the literal |
*/ |
void set literal(Token literal2) { |
@@ -4591,6 +5113,7 @@ class DoubleLiteral extends Literal { |
/** |
* Set the value of the literal to the given value. |
+ * |
* @param value the value of the literal |
*/ |
void set value(double value2) { |
@@ -4602,10 +5125,12 @@ class DoubleLiteral extends Literal { |
/** |
* Instances of the class `EmptyFunctionBody` represent an empty function body, which can only |
* appear in constructors or abstract methods. |
+ * |
* <pre> |
* emptyFunctionBody ::= |
- * ';' |
+ * ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class EmptyFunctionBody extends FunctionBody { |
@@ -4617,6 +5142,7 @@ class EmptyFunctionBody extends FunctionBody { |
/** |
* Initialize a newly created function body. |
+ * |
* @param semicolon the token representing the semicolon that marks the end of the function body |
*/ |
EmptyFunctionBody.full(Token semicolon) { |
@@ -4625,6 +5151,7 @@ class EmptyFunctionBody extends FunctionBody { |
/** |
* Initialize a newly created function body. |
+ * |
* @param semicolon the token representing the semicolon that marks the end of the function body |
*/ |
EmptyFunctionBody({Token semicolon}) : this.full(semicolon); |
@@ -4634,6 +5161,7 @@ class EmptyFunctionBody extends FunctionBody { |
/** |
* Return the token representing the semicolon that marks the end of the function body. |
+ * |
* @return the token representing the semicolon that marks the end of the function body |
*/ |
Token get semicolon => _semicolon; |
@@ -4641,6 +5169,7 @@ class EmptyFunctionBody extends FunctionBody { |
/** |
* Set the token representing the semicolon that marks the end of the function body to the given |
* token. |
+ * |
* @param semicolon the token representing the semicolon that marks the end of the function body |
*/ |
void set semicolon(Token semicolon2) { |
@@ -4651,10 +5180,12 @@ class EmptyFunctionBody extends FunctionBody { |
} |
/** |
* Instances of the class `EmptyStatement` represent an empty statement. |
+ * |
* <pre> |
* emptyStatement ::= |
- * ';' |
+ * ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class EmptyStatement extends Statement { |
@@ -4666,6 +5197,7 @@ class EmptyStatement extends Statement { |
/** |
* Initialize a newly created empty statement. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
EmptyStatement.full(Token semicolon) { |
@@ -4674,6 +5206,7 @@ class EmptyStatement extends Statement { |
/** |
* Initialize a newly created empty statement. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
EmptyStatement({Token semicolon}) : this.full(semicolon); |
@@ -4683,12 +5216,14 @@ class EmptyStatement extends Statement { |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -4699,6 +5234,7 @@ class EmptyStatement extends Statement { |
} |
/** |
* Ephemeral identifiers are created as needed to mimic the presence of an empty identifier. |
+ * |
* @coverage dart.engine.ast |
*/ |
class EphemeralIdentifier extends SimpleIdentifier { |
@@ -4709,15 +5245,19 @@ class EphemeralIdentifier extends SimpleIdentifier { |
} |
/** |
* Instances of the class `ExportDirective` represent an export directive. |
+ * |
* <pre> |
- * exportDirective ::=[Annotation metadata] 'export' [StringLiteral libraryUri] [Combinator combinator]* ';' |
+ * exportDirective ::= |
+ * [Annotation] 'export' [StringLiteral] [Combinator]* ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ExportDirective extends NamespaceDirective { |
/** |
* Initialize a newly created export directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param keyword the token representing the 'export' keyword |
@@ -4730,6 +5270,7 @@ class ExportDirective extends NamespaceDirective { |
/** |
* Initialize a newly created export directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param keyword the token representing the 'export' keyword |
@@ -4754,9 +5295,14 @@ class ExportDirective extends NamespaceDirective { |
/** |
* Instances of the class `Expression` defines the behavior common to nodes that represent an |
* expression. |
+ * |
* <pre> |
- * expression ::=[AssignmentExpression assignmentExpression]| [ConditionalExpression conditionalExpression] cascadeSection |
- * | [ThrowExpression throwExpression]</pre> |
+ * expression ::= |
+ * [AssignmentExpression] |
+ * | [ConditionalExpression] cascadeSection* |
+ * | [ThrowExpression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class Expression extends ASTNode { |
@@ -4778,8 +5324,9 @@ abstract class Expression extends ASTNode { |
* expression corresponds to one of the parameters of the function being invoked, then return the |
* parameter element representing the parameter to which the value of this expression will be |
* bound. Otherwise, return `null`. |
+ * |
* @return the parameter element representing the parameter to which the value of this expression |
- * will be bound |
+ * will be bound |
*/ |
ParameterElement get parameterElement { |
ASTNode parent = this.parent; |
@@ -4806,6 +5353,7 @@ abstract class Expression extends ASTNode { |
/** |
* Return the propagated type of this expression, or `null` if type propagation has not been |
* performed on the AST structure. |
+ * |
* @return the propagated type of this expression |
*/ |
Type2 get propagatedType => _propagatedType; |
@@ -4816,8 +5364,9 @@ abstract class Expression extends ASTNode { |
* corresponds to one of the parameters of the function being invoked, then return the parameter |
* element representing the parameter to which the value of this expression will be bound. |
* Otherwise, return `null`. |
+ * |
* @return the parameter element representing the parameter to which the value of this expression |
- * will be bound |
+ * will be bound |
*/ |
ParameterElement get staticParameterElement { |
ASTNode parent = this.parent; |
@@ -4844,18 +5393,22 @@ abstract class Expression extends ASTNode { |
/** |
* Return the static type of this expression, or `null` if the AST structure has not been |
* resolved. |
+ * |
* @return the static type of this expression |
*/ |
Type2 get staticType => _staticType; |
/** |
- * Return `true` if this expression is syntactically valid for the LHS of an[AssignmentExpression assignment expression]. |
+ * Return `true` if this expression is syntactically valid for the LHS of an |
+ * [AssignmentExpression]. |
+ * |
* @return `true` if this expression matches the `assignableExpression` production |
*/ |
bool get isAssignable => false; |
/** |
* Set the propagated type of this expression to the given type. |
+ * |
* @param propagatedType the propagated type of this expression |
*/ |
void set propagatedType(Type2 propagatedType2) { |
@@ -4864,6 +5417,7 @@ abstract class Expression extends ASTNode { |
/** |
* Set the static type of this expression to the given type. |
+ * |
* @param staticType the static type of this expression |
*/ |
void set staticType(Type2 staticType2) { |
@@ -4873,10 +5427,12 @@ abstract class Expression extends ASTNode { |
/** |
* Instances of the class `ExpressionFunctionBody` represent a function body consisting of a |
* single expression. |
+ * |
* <pre> |
* expressionFunctionBody ::= |
- * '=>' [Expression expression] ';' |
+ * '=>' [Expression] ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ExpressionFunctionBody extends FunctionBody { |
@@ -4898,8 +5454,9 @@ class ExpressionFunctionBody extends FunctionBody { |
/** |
* Initialize a newly created function body consisting of a block of statements. |
+ * |
* @param functionDefinition the token introducing the expression that represents the body of the |
- * function |
+ * function |
* @param expression the expression representing the body of the function |
* @param semicolon the semicolon terminating the statement |
*/ |
@@ -4911,8 +5468,9 @@ class ExpressionFunctionBody extends FunctionBody { |
/** |
* Initialize a newly created function body consisting of a block of statements. |
+ * |
* @param functionDefinition the token introducing the expression that represents the body of the |
- * function |
+ * function |
* @param expression the expression representing the body of the function |
* @param semicolon the semicolon terminating the statement |
*/ |
@@ -4928,24 +5486,28 @@ class ExpressionFunctionBody extends FunctionBody { |
/** |
* Return the expression representing the body of the function. |
+ * |
* @return the expression representing the body of the function |
*/ |
Expression get expression => _expression; |
/** |
* Return the token introducing the expression that represents the body of the function. |
+ * |
* @return the function definition token |
*/ |
Token get functionDefinition => _functionDefinition; |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the expression representing the body of the function to the given expression. |
+ * |
* @param expression the expression representing the body of the function |
*/ |
void set expression(Expression expression2) { |
@@ -4955,6 +5517,7 @@ class ExpressionFunctionBody extends FunctionBody { |
/** |
* Set the token introducing the expression that represents the body of the function to the given |
* token. |
+ * |
* @param functionDefinition the function definition token |
*/ |
void set functionDefinition(Token functionDefinition2) { |
@@ -4963,6 +5526,7 @@ class ExpressionFunctionBody extends FunctionBody { |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -4974,9 +5538,12 @@ class ExpressionFunctionBody extends FunctionBody { |
} |
/** |
* Instances of the class `ExpressionStatement` wrap an expression as a statement. |
+ * |
* <pre> |
- * expressionStatement ::=[Expression expression]? ';' |
+ * expressionStatement ::= |
+ * [Expression]? ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ExpressionStatement extends Statement { |
@@ -4994,6 +5561,7 @@ class ExpressionStatement extends Statement { |
/** |
* Initialize a newly created expression statement. |
+ * |
* @param expression the expression that comprises the statement |
* @param semicolon the semicolon terminating the statement |
*/ |
@@ -5004,6 +5572,7 @@ class ExpressionStatement extends Statement { |
/** |
* Initialize a newly created expression statement. |
+ * |
* @param expression the expression that comprises the statement |
* @param semicolon the semicolon terminating the statement |
*/ |
@@ -5019,12 +5588,14 @@ class ExpressionStatement extends Statement { |
/** |
* Return the expression that comprises the statement. |
+ * |
* @return the expression that comprises the statement |
*/ |
Expression get expression => _expression; |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
@@ -5032,6 +5603,7 @@ class ExpressionStatement extends Statement { |
/** |
* Set the expression that comprises the statement to the given expression. |
+ * |
* @param expression the expression that comprises the statement |
*/ |
void set expression(Expression expression2) { |
@@ -5040,6 +5612,7 @@ class ExpressionStatement extends Statement { |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -5052,9 +5625,12 @@ class ExpressionStatement extends Statement { |
/** |
* Instances of the class `ExtendsClause` represent the "extends" clause in a class |
* declaration. |
+ * |
* <pre> |
* extendsClause ::= |
- * 'extends' [TypeName superclass]</pre> |
+ * 'extends' [TypeName] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ExtendsClause extends ASTNode { |
@@ -5071,6 +5647,7 @@ class ExtendsClause extends ASTNode { |
/** |
* Initialize a newly created extends clause. |
+ * |
* @param keyword the token representing the 'extends' keyword |
* @param superclass the name of the class that is being extended |
*/ |
@@ -5081,6 +5658,7 @@ class ExtendsClause extends ASTNode { |
/** |
* Initialize a newly created extends clause. |
+ * |
* @param keyword the token representing the 'extends' keyword |
* @param superclass the name of the class that is being extended |
*/ |
@@ -5091,18 +5669,21 @@ class ExtendsClause extends ASTNode { |
/** |
* Return the token representing the 'extends' keyword. |
+ * |
* @return the token representing the 'extends' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the name of the class that is being extended. |
+ * |
* @return the name of the class that is being extended |
*/ |
TypeName get superclass => _superclass; |
/** |
* Set the token representing the 'extends' keyword to the given token. |
+ * |
* @param keyword the token representing the 'extends' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -5111,6 +5692,7 @@ class ExtendsClause extends ASTNode { |
/** |
* Set the name of the class that is being extended to the given name. |
+ * |
* @param name the name of the class that is being extended |
*/ |
void set superclass(TypeName name) { |
@@ -5123,10 +5705,12 @@ class ExtendsClause extends ASTNode { |
/** |
* Instances of the class `FieldDeclaration` represent the declaration of one or more fields |
* of the same type. |
+ * |
* <pre> |
* fieldDeclaration ::= |
- * 'static'? [VariableDeclarationList fieldList] ';' |
+ * 'static'? [VariableDeclarationList] ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class FieldDeclaration extends ClassMember { |
@@ -5148,6 +5732,7 @@ class FieldDeclaration extends ClassMember { |
/** |
* Initialize a newly created field declaration. |
+ * |
* @param comment the documentation comment associated with this field |
* @param metadata the annotations associated with this field |
* @param keyword the token representing the 'static' keyword |
@@ -5162,6 +5747,7 @@ class FieldDeclaration extends ClassMember { |
/** |
* Initialize a newly created field declaration. |
+ * |
* @param comment the documentation comment associated with this field |
* @param metadata the annotations associated with this field |
* @param keyword the token representing the 'static' keyword |
@@ -5175,6 +5761,7 @@ class FieldDeclaration extends ClassMember { |
/** |
* Return the fields being declared. |
+ * |
* @return the fields being declared |
*/ |
VariableDeclarationList get fields => _fieldList; |
@@ -5182,24 +5769,28 @@ class FieldDeclaration extends ClassMember { |
/** |
* Return the token representing the 'static' keyword, or `null` if the fields are not |
* static. |
+ * |
* @return the token representing the 'static' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the semicolon terminating the declaration. |
+ * |
* @return the semicolon terminating the declaration |
*/ |
Token get semicolon => _semicolon; |
/** |
* Return `true` if the fields are static. |
+ * |
* @return `true` if the fields are declared to be static |
*/ |
bool get isStatic => _keyword != null; |
/** |
* Set the fields being declared to the given list of variables. |
+ * |
* @param fieldList the fields being declared |
*/ |
void set fields(VariableDeclarationList fieldList) { |
@@ -5208,6 +5799,7 @@ class FieldDeclaration extends ClassMember { |
/** |
* Set the token representing the 'static' keyword to the given token. |
+ * |
* @param keyword the token representing the 'static' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -5216,6 +5808,7 @@ class FieldDeclaration extends ClassMember { |
/** |
* Set the semicolon terminating the declaration to the given token. |
+ * |
* @param semicolon the semicolon terminating the declaration |
*/ |
void set semicolon(Token semicolon2) { |
@@ -5234,9 +5827,12 @@ class FieldDeclaration extends ClassMember { |
} |
/** |
* Instances of the class `FieldFormalParameter` represent a field formal parameter. |
+ * |
* <pre> |
* fieldFormalParameter ::= |
- * ('final' [TypeName type] | 'const' [TypeName type] | 'var' | [TypeName type])? 'this' '.' [SimpleIdentifier identifier]</pre> |
+ * ('final' [TypeName] | 'const' [TypeName] | 'var' | [TypeName])? 'this' '.' [SimpleIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class FieldFormalParameter extends NormalFormalParameter { |
@@ -5265,6 +5861,7 @@ class FieldFormalParameter extends NormalFormalParameter { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
@@ -5282,6 +5879,7 @@ class FieldFormalParameter extends NormalFormalParameter { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
@@ -5304,18 +5902,21 @@ class FieldFormalParameter extends NormalFormalParameter { |
/** |
* Return the token representing either the 'final', 'const' or 'var' keyword. |
+ * |
* @return the token representing either the 'final', 'const' or 'var' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the token representing the period. |
+ * |
* @return the token representing the period |
*/ |
Token get period => _period; |
/** |
* Return the token representing the 'this' keyword. |
+ * |
* @return the token representing the 'this' keyword |
*/ |
Token get thisToken => _thisToken; |
@@ -5323,6 +5924,7 @@ class FieldFormalParameter extends NormalFormalParameter { |
/** |
* Return the name of the declared type of the parameter, or `null` if the parameter does |
* not have a declared type. |
+ * |
* @return the name of the declared type of the parameter |
*/ |
TypeName get type => _type; |
@@ -5331,6 +5933,7 @@ class FieldFormalParameter extends NormalFormalParameter { |
/** |
* Set the token representing either the 'final', 'const' or 'var' keyword to the given token. |
+ * |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -5339,6 +5942,7 @@ class FieldFormalParameter extends NormalFormalParameter { |
/** |
* Set the token representing the period to the given token. |
+ * |
* @param period the token representing the period |
*/ |
void set period(Token period2) { |
@@ -5347,6 +5951,7 @@ class FieldFormalParameter extends NormalFormalParameter { |
/** |
* Set the token representing the 'this' keyword to the given token. |
+ * |
* @param thisToken the token representing the 'this' keyword |
*/ |
void set thisToken(Token thisToken2) { |
@@ -5355,6 +5960,7 @@ class FieldFormalParameter extends NormalFormalParameter { |
/** |
* Set the name of the declared type of the parameter to the given type name. |
+ * |
* @param typeName the name of the declared type of the parameter |
*/ |
void set type(TypeName typeName) { |
@@ -5368,9 +5974,12 @@ class FieldFormalParameter extends NormalFormalParameter { |
} |
/** |
* Instances of the class `ForEachStatement` represent a for-each statement. |
+ * |
* <pre> |
* forEachStatement ::= |
- * 'for' '(' [SimpleFormalParameter loopParameter] 'in' [Expression iterator] ')' [Block body]</pre> |
+ * 'for' '(' [SimpleFormalParameter] 'in' [Expression] ')' [Block] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ForEachStatement extends Statement { |
@@ -5412,6 +6021,7 @@ class ForEachStatement extends Statement { |
/** |
* Initialize a newly created for-each statement. |
+ * |
* @param forKeyword the token representing the 'for' keyword |
* @param leftParenthesis the left parenthesis |
* @param loopVariable the declaration of the loop variable |
@@ -5431,6 +6041,7 @@ class ForEachStatement extends Statement { |
/** |
* Initialize a newly created for-each statement. |
+ * |
* @param forKeyword the token representing the 'for' keyword |
* @param leftParenthesis the left parenthesis |
* @param loopVariable the declaration of the loop variable |
@@ -5444,6 +6055,7 @@ class ForEachStatement extends Statement { |
/** |
* Return the body of the loop. |
+ * |
* @return the body of the loop |
*/ |
Statement get body => _body; |
@@ -5451,42 +6063,49 @@ class ForEachStatement extends Statement { |
/** |
* Return the token representing the 'for' keyword. |
+ * |
* @return the token representing the 'for' keyword |
*/ |
Token get forKeyword => _forKeyword; |
/** |
* Return the token representing the 'in' keyword. |
+ * |
* @return the token representing the 'in' keyword |
*/ |
Token get inKeyword => _inKeyword; |
/** |
* Return the expression evaluated to produce the iterator. |
+ * |
* @return the expression evaluated to produce the iterator |
*/ |
Expression get iterator => _iterator; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the declaration of the loop variable. |
+ * |
* @return the declaration of the loop variable |
*/ |
DeclaredIdentifier get loopVariable => _loopVariable; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
* Set the body of the loop to the given block. |
+ * |
* @param body the body of the loop |
*/ |
void set body(Statement body2) { |
@@ -5495,6 +6114,7 @@ class ForEachStatement extends Statement { |
/** |
* Set the token representing the 'for' keyword to the given token. |
+ * |
* @param forKeyword the token representing the 'for' keyword |
*/ |
void set forKeyword(Token forKeyword2) { |
@@ -5503,6 +6123,7 @@ class ForEachStatement extends Statement { |
/** |
* Set the token representing the 'in' keyword to the given token. |
+ * |
* @param inKeyword the token representing the 'in' keyword |
*/ |
void set inKeyword(Token inKeyword2) { |
@@ -5511,6 +6132,7 @@ class ForEachStatement extends Statement { |
/** |
* Set the expression evaluated to produce the iterator to the given expression. |
+ * |
* @param expression the expression evaluated to produce the iterator |
*/ |
void set iterator(Expression expression) { |
@@ -5519,6 +6141,7 @@ class ForEachStatement extends Statement { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param leftParenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token leftParenthesis2) { |
@@ -5527,6 +6150,7 @@ class ForEachStatement extends Statement { |
/** |
* Set the declaration of the loop variable to the given variable. |
+ * |
* @param variable the declaration of the loop variable |
*/ |
void set loopVariable(DeclaredIdentifier variable) { |
@@ -5535,6 +6159,7 @@ class ForEachStatement extends Statement { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param rightParenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token rightParenthesis2) { |
@@ -5548,12 +6173,19 @@ class ForEachStatement extends Statement { |
} |
/** |
* Instances of the class `ForStatement` represent a for statement. |
+ * |
* <pre> |
* forStatement ::= |
- * 'for' '(' forLoopParts ')' [Statement statement]forLoopParts ::= |
- * forInitializerStatement ';' [Expression expression]? ';' [Expression expressionList]? |
- * forInitializerStatement ::=[DefaultFormalParameter initializedVariableDeclaration]| [Expression expression]? |
+ * 'for' '(' forLoopParts ')' [Statement] |
+ * |
+ * forLoopParts ::= |
+ * forInitializerStatement ';' [Expression]? ';' [Expression]? |
+ * |
+ * forInitializerStatement ::= |
+ * [DefaultFormalParameter] |
+ * | [Expression]? |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ForStatement extends Statement { |
@@ -5614,6 +6246,7 @@ class ForStatement extends Statement { |
/** |
* Initialize a newly created for statement. |
+ * |
* @param forKeyword the token representing the 'for' keyword |
* @param leftParenthesis the left parenthesis |
* @param variableList the declaration of the loop variables |
@@ -5641,6 +6274,7 @@ class ForStatement extends Statement { |
/** |
* Initialize a newly created for statement. |
+ * |
* @param forKeyword the token representing the 'for' keyword |
* @param leftParenthesis the left parenthesis |
* @param variableList the declaration of the loop variables |
@@ -5658,12 +6292,14 @@ class ForStatement extends Statement { |
/** |
* Return the body of the loop. |
+ * |
* @return the body of the loop |
*/ |
Statement get body => _body; |
/** |
* Return the condition used to determine when to terminate the loop. |
+ * |
* @return the condition used to determine when to terminate the loop |
*/ |
Expression get condition => _condition; |
@@ -5671,54 +6307,63 @@ class ForStatement extends Statement { |
/** |
* Return the token representing the 'for' keyword. |
+ * |
* @return the token representing the 'for' keyword |
*/ |
Token get forKeyword => _forKeyword; |
/** |
* Return the initialization expression, or `null` if there is no initialization expression. |
+ * |
* @return the initialization expression |
*/ |
Expression get initialization => _initialization; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the semicolon separating the initializer and the condition. |
+ * |
* @return the semicolon separating the initializer and the condition |
*/ |
Token get leftSeparator => _leftSeparator; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
* Return the semicolon separating the condition and the updater. |
+ * |
* @return the semicolon separating the condition and the updater |
*/ |
Token get rightSeparator => _rightSeparator; |
/** |
* Return the list of expressions run after each execution of the loop body. |
+ * |
* @return the list of expressions run after each execution of the loop body |
*/ |
NodeList<Expression> get updaters => _updaters; |
/** |
* Return the declaration of the loop variables, or `null` if there are no variables. |
+ * |
* @return the declaration of the loop variables, or `null` if there are no variables |
*/ |
VariableDeclarationList get variables => _variableList; |
/** |
* Set the body of the loop to the given statement. |
+ * |
* @param body the body of the loop |
*/ |
void set body(Statement body2) { |
@@ -5727,6 +6372,7 @@ class ForStatement extends Statement { |
/** |
* Set the condition used to determine when to terminate the loop to the given expression. |
+ * |
* @param expression the condition used to determine when to terminate the loop |
*/ |
void set condition(Expression expression) { |
@@ -5735,6 +6381,7 @@ class ForStatement extends Statement { |
/** |
* Set the token representing the 'for' keyword to the given token. |
+ * |
* @param forKeyword the token representing the 'for' keyword |
*/ |
void set forKeyword(Token forKeyword2) { |
@@ -5743,6 +6390,7 @@ class ForStatement extends Statement { |
/** |
* Set the initialization expression to the given expression. |
+ * |
* @param initialization the initialization expression |
*/ |
void set initialization(Expression initialization2) { |
@@ -5751,6 +6399,7 @@ class ForStatement extends Statement { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param leftParenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token leftParenthesis2) { |
@@ -5759,6 +6408,7 @@ class ForStatement extends Statement { |
/** |
* Set the semicolon separating the initializer and the condition to the given token. |
+ * |
* @param leftSeparator the semicolon separating the initializer and the condition |
*/ |
void set leftSeparator(Token leftSeparator2) { |
@@ -5767,6 +6417,7 @@ class ForStatement extends Statement { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param rightParenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token rightParenthesis2) { |
@@ -5775,6 +6426,7 @@ class ForStatement extends Statement { |
/** |
* Set the semicolon separating the condition and the updater to the given token. |
+ * |
* @param rightSeparator the semicolon separating the condition and the updater |
*/ |
void set rightSeparator(Token rightSeparator2) { |
@@ -5783,6 +6435,7 @@ class ForStatement extends Statement { |
/** |
* Set the declaration of the loop variables to the given parameter. |
+ * |
* @param variableList the declaration of the loop variables |
*/ |
void set variables(VariableDeclarationList variableList) { |
@@ -5799,8 +6452,14 @@ class ForStatement extends Statement { |
/** |
* The abstract class `FormalParameter` defines the behavior of objects representing a |
* parameter to a function. |
+ * |
* <pre> |
- * formalParameter ::=[NormalFormalParameter normalFormalParameter]| [DefaultFormalParameter namedFormalParameter]| [DefaultFormalParameter optionalFormalParameter]</pre> |
+ * formalParameter ::= |
+ * [NormalFormalParameter] |
+ * | [DefaultFormalParameter] |
+ * | [DefaultFormalParameter] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class FormalParameter extends ASTNode { |
@@ -5808,6 +6467,7 @@ abstract class FormalParameter extends ASTNode { |
/** |
* Return the element representing this parameter, or `null` if this parameter has not been |
* resolved. |
+ * |
* @return the element representing this parameter |
*/ |
ParameterElement get element { |
@@ -5820,12 +6480,14 @@ abstract class FormalParameter extends ASTNode { |
/** |
* Return the name of the parameter being declared. |
+ * |
* @return the name of the parameter being declared |
*/ |
SimpleIdentifier get identifier; |
/** |
* Return the kind of this parameter. |
+ * |
* @return the kind of this parameter |
*/ |
ParameterKind get kind; |
@@ -5838,20 +6500,27 @@ abstract class FormalParameter extends ASTNode { |
* parameters and at most one grouping of optional formal parameters, this class does not enforce |
* those constraints. All parameters are flattened into a single list, which can have any or all |
* kinds of parameters (normal, named, and positional) in any order. |
+ * |
* <pre> |
* formalParameterList ::= |
- * '(' ')' |
- * | '(' normalFormalParameters (',' optionalFormalParameters)? ')' |
- * | '(' optionalFormalParameters ')' |
- * normalFormalParameters ::=[NormalFormalParameter normalFormalParameter] (',' [NormalFormalParameter normalFormalParameter]) |
+ * '(' ')' |
+ * | '(' normalFormalParameters (',' optionalFormalParameters)? ')' |
+ * | '(' optionalFormalParameters ')' |
+ * |
+ * normalFormalParameters ::= |
+ * [NormalFormalParameter] (',' [NormalFormalParameter])* |
+ * |
* optionalFormalParameters ::= |
- * optionalPositionalFormalParameters |
- * | namedFormalParameters |
+ * optionalPositionalFormalParameters |
+ * | namedFormalParameters |
+ * |
* optionalPositionalFormalParameters ::= |
- * '\[' [DefaultFormalParameter positionalFormalParameter] (',' [DefaultFormalParameter positionalFormalParameter])* '\]' |
+ * '[' [DefaultFormalParameter] (',' [DefaultFormalParameter])* ']' |
+ * |
* namedFormalParameters ::= |
- * '{' [DefaultFormalParameter namedFormalParameter] (',' [DefaultFormalParameter namedFormalParameter])* '}' |
+ * '{' [DefaultFormalParameter] (',' [DefaultFormalParameter])* '}' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class FormalParameterList extends ASTNode { |
@@ -5867,12 +6536,12 @@ class FormalParameterList extends ASTNode { |
NodeList<FormalParameter> _parameters; |
/** |
- * The left square bracket ('\[') or left curly brace ('{') introducing the optional parameters. |
+ * The left square bracket ('[') or left curly brace ('{') introducing the optional parameters. |
*/ |
Token _leftDelimiter; |
/** |
- * The right square bracket ('\]') or right curly brace ('}') introducing the optional parameters. |
+ * The right square bracket (']') or right curly brace ('}') introducing the optional parameters. |
*/ |
Token _rightDelimiter; |
@@ -5883,6 +6552,7 @@ class FormalParameterList extends ASTNode { |
/** |
* Initialize a newly created parameter list. |
+ * |
* @param leftParenthesis the left parenthesis |
* @param parameters the parameters associated with the method |
* @param leftDelimiter the left delimiter introducing the optional parameters |
@@ -5900,6 +6570,7 @@ class FormalParameterList extends ASTNode { |
/** |
* Initialize a newly created parameter list. |
+ * |
* @param leftParenthesis the left parenthesis |
* @param parameters the parameters associated with the method |
* @param leftDelimiter the left delimiter introducing the optional parameters |
@@ -5913,6 +6584,7 @@ class FormalParameterList extends ASTNode { |
/** |
* Return an array containing the elements representing the parameters in this list. The array |
* will contain `null`s if the parameters in this list have not been resolved. |
+ * |
* @return the elements representing the parameters in this list |
*/ |
List<ParameterElement> get elements { |
@@ -5926,42 +6598,48 @@ class FormalParameterList extends ASTNode { |
Token get endToken => _rightParenthesis; |
/** |
- * Return the left square bracket ('\[') or left curly brace ('{') introducing the optional |
+ * Return the left square bracket ('[') or left curly brace ('{') introducing the optional |
* parameters. |
- * @return the left square bracket ('\[') or left curly brace ('{') introducing the optional |
- * parameters |
+ * |
+ * @return the left square bracket ('[') or left curly brace ('{') introducing the optional |
+ * parameters |
*/ |
Token get leftDelimiter => _leftDelimiter; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the parameters associated with the method. |
+ * |
* @return the parameters associated with the method |
*/ |
NodeList<FormalParameter> get parameters => _parameters; |
/** |
- * Return the right square bracket ('\]') or right curly brace ('}') introducing the optional |
+ * Return the right square bracket (']') or right curly brace ('}') introducing the optional |
* parameters. |
- * @return the right square bracket ('\]') or right curly brace ('}') introducing the optional |
- * parameters |
+ * |
+ * @return the right square bracket (']') or right curly brace ('}') introducing the optional |
+ * parameters |
*/ |
Token get rightDelimiter => _rightDelimiter; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
- * Set the left square bracket ('\[') or left curly brace ('{') introducing the optional parameters |
+ * Set the left square bracket ('[') or left curly brace ('{') introducing the optional parameters |
* to the given token. |
+ * |
* @param bracket the left delimiter introducing the optional parameters |
*/ |
void set leftDelimiter(Token bracket) { |
@@ -5970,6 +6648,7 @@ class FormalParameterList extends ASTNode { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param parenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token parenthesis) { |
@@ -5977,8 +6656,9 @@ class FormalParameterList extends ASTNode { |
} |
/** |
- * Set the right square bracket ('\]') or right curly brace ('}') introducing the optional |
+ * Set the right square bracket (']') or right curly brace ('}') introducing the optional |
* parameters to the given token. |
+ * |
* @param bracket the right delimiter introducing the optional parameters |
*/ |
void set rightDelimiter(Token bracket) { |
@@ -5987,6 +6667,7 @@ class FormalParameterList extends ASTNode { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param parenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token parenthesis) { |
@@ -5999,19 +6680,30 @@ class FormalParameterList extends ASTNode { |
/** |
* The abstract class `FunctionBody` defines the behavior common to objects representing the |
* body of a function or method. |
+ * |
* <pre> |
- * functionBody ::=[BlockFunctionBody blockFunctionBody]| [EmptyFunctionBody emptyFunctionBody]| [ExpressionFunctionBody expressionFunctionBody]</pre> |
+ * functionBody ::= |
+ * [BlockFunctionBody] |
+ * | [EmptyFunctionBody] |
+ * | [ExpressionFunctionBody] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class FunctionBody extends ASTNode { |
} |
/** |
- * Instances of the class `FunctionDeclaration` wrap a [FunctionExpression function |
- * expression] as a top-level declaration. |
+ * Instances of the class `FunctionDeclaration` wrap a [FunctionExpression] as a top-level declaration. |
+ * |
* <pre> |
* functionDeclaration ::= |
- * 'external' functionSignature |
- * | functionSignature [FunctionBody functionBody]functionSignature ::=[Type returnType]? ('get' | 'set')? [SimpleIdentifier functionName] [FormalParameterList formalParameterList]</pre> |
+ * 'external' functionSignature |
+ * | functionSignature [FunctionBody] |
+ * |
+ * functionSignature ::= |
+ * [Type]? ('get' | 'set')? [SimpleIdentifier] [FormalParameterList] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class FunctionDeclaration extends CompilationUnitMember { |
@@ -6045,6 +6737,7 @@ class FunctionDeclaration extends CompilationUnitMember { |
/** |
* Initialize a newly created function declaration. |
+ * |
* @param comment the documentation comment associated with this function |
* @param metadata the annotations associated with this function |
* @param externalKeyword the token representing the 'external' keyword |
@@ -6063,6 +6756,7 @@ class FunctionDeclaration extends CompilationUnitMember { |
/** |
* Initialize a newly created function declaration. |
+ * |
* @param comment the documentation comment associated with this function |
* @param metadata the annotations associated with this function |
* @param externalKeyword the token representing the 'external' keyword |
@@ -6079,18 +6773,21 @@ class FunctionDeclaration extends CompilationUnitMember { |
/** |
* Return the token representing the 'external' keyword, or `null` if this is not an |
* external function. |
+ * |
* @return the token representing the 'external' keyword |
*/ |
Token get externalKeyword => _externalKeyword; |
/** |
* Return the function expression being wrapped. |
+ * |
* @return the function expression being wrapped |
*/ |
FunctionExpression get functionExpression => _functionExpression; |
/** |
* Return the name of the function, or `null` if the function is not named. |
+ * |
* @return the name of the function |
*/ |
SimpleIdentifier get name => _name; |
@@ -6098,30 +6795,35 @@ class FunctionDeclaration extends CompilationUnitMember { |
/** |
* Return the token representing the 'get' or 'set' keyword, or `null` if this is a function |
* declaration rather than a property declaration. |
+ * |
* @return the token representing the 'get' or 'set' keyword |
*/ |
Token get propertyKeyword => _propertyKeyword; |
/** |
* Return the return type of the function, or `null` if no return type was declared. |
+ * |
* @return the return type of the function |
*/ |
TypeName get returnType => _returnType; |
/** |
* Return `true` if this function declares a getter. |
+ * |
* @return `true` if this function declares a getter |
*/ |
bool get isGetter => _propertyKeyword != null && identical(((_propertyKeyword as KeywordToken)).keyword, Keyword.GET); |
/** |
* Return `true` if this function declares a setter. |
+ * |
* @return `true` if this function declares a setter |
*/ |
bool get isSetter => _propertyKeyword != null && identical(((_propertyKeyword as KeywordToken)).keyword, Keyword.SET); |
/** |
* Set the token representing the 'external' keyword to the given token. |
+ * |
* @param externalKeyword the token representing the 'external' keyword |
*/ |
void set externalKeyword(Token externalKeyword2) { |
@@ -6130,6 +6832,7 @@ class FunctionDeclaration extends CompilationUnitMember { |
/** |
* Set the function expression being wrapped to the given function expression. |
+ * |
* @param functionExpression the function expression being wrapped |
*/ |
void set functionExpression(FunctionExpression functionExpression2) { |
@@ -6138,6 +6841,7 @@ class FunctionDeclaration extends CompilationUnitMember { |
/** |
* Set the name of the function to the given identifier. |
+ * |
* @param identifier the name of the function |
*/ |
void set name(SimpleIdentifier identifier) { |
@@ -6146,6 +6850,7 @@ class FunctionDeclaration extends CompilationUnitMember { |
/** |
* Set the token representing the 'get' or 'set' keyword to the given token. |
+ * |
* @param propertyKeyword the token representing the 'get' or 'set' keyword |
*/ |
void set propertyKeyword(Token propertyKeyword2) { |
@@ -6154,6 +6859,7 @@ class FunctionDeclaration extends CompilationUnitMember { |
/** |
* Set the return type of the function to the given name. |
+ * |
* @param name the return type of the function |
*/ |
void set returnType(TypeName name) { |
@@ -6180,7 +6886,9 @@ class FunctionDeclaration extends CompilationUnitMember { |
} |
} |
/** |
- * Instances of the class `FunctionDeclarationStatement` wrap a [FunctionDeclarationfunction declaration] as a statement. |
+ * Instances of the class `FunctionDeclarationStatement` wrap a [FunctionDeclaration |
+ ] as a statement. |
+ * |
* @coverage dart.engine.ast |
*/ |
class FunctionDeclarationStatement extends Statement { |
@@ -6192,6 +6900,7 @@ class FunctionDeclarationStatement extends Statement { |
/** |
* Initialize a newly created function declaration statement. |
+ * |
* @param functionDeclaration the the function declaration being wrapped |
*/ |
FunctionDeclarationStatement.full(FunctionDeclaration functionDeclaration) { |
@@ -6200,6 +6909,7 @@ class FunctionDeclarationStatement extends Statement { |
/** |
* Initialize a newly created function declaration statement. |
+ * |
* @param functionDeclaration the the function declaration being wrapped |
*/ |
FunctionDeclarationStatement({FunctionDeclaration functionDeclaration}) : this.full(functionDeclaration); |
@@ -6209,12 +6919,14 @@ class FunctionDeclarationStatement extends Statement { |
/** |
* Return the function declaration being wrapped. |
+ * |
* @return the function declaration being wrapped |
*/ |
FunctionDeclaration get functionDeclaration => _functionDeclaration; |
/** |
* Set the function declaration being wrapped to the given function declaration. |
+ * |
* @param functionDeclaration the function declaration being wrapped |
*/ |
void set functionExpression(FunctionDeclaration functionDeclaration2) { |
@@ -6226,8 +6938,12 @@ class FunctionDeclarationStatement extends Statement { |
} |
/** |
* Instances of the class `FunctionExpression` represent a function expression. |
+ * |
* <pre> |
- * functionExpression ::=[FormalParameterList formalParameterList] [FunctionBody functionBody]</pre> |
+ * functionExpression ::= |
+ * [FormalParameterList] [FunctionBody] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class FunctionExpression extends Expression { |
@@ -6250,6 +6966,7 @@ class FunctionExpression extends Expression { |
/** |
* Initialize a newly created function declaration. |
+ * |
* @param parameters the parameters associated with the function |
* @param body the body of the function |
*/ |
@@ -6260,6 +6977,7 @@ class FunctionExpression extends Expression { |
/** |
* Initialize a newly created function declaration. |
+ * |
* @param parameters the parameters associated with the function |
* @param body the body of the function |
*/ |
@@ -6276,6 +6994,7 @@ class FunctionExpression extends Expression { |
/** |
* Return the body of the function, or `null` if this is an external function. |
+ * |
* @return the body of the function |
*/ |
FunctionBody get body => _body; |
@@ -6283,6 +7002,7 @@ class FunctionExpression extends Expression { |
/** |
* Return the element associated with this function, or `null` if the AST structure has not |
* been resolved. |
+ * |
* @return the element associated with this function |
*/ |
ExecutableElement get element => _element; |
@@ -6297,12 +7017,14 @@ class FunctionExpression extends Expression { |
/** |
* Return the parameters associated with the function. |
+ * |
* @return the parameters associated with the function |
*/ |
FormalParameterList get parameters => _parameters; |
/** |
* Set the body of the function to the given function body. |
+ * |
* @param functionBody the body of the function |
*/ |
void set body(FunctionBody functionBody) { |
@@ -6311,6 +7033,7 @@ class FunctionExpression extends Expression { |
/** |
* Set the element associated with this function to the given element. |
+ * |
* @param element the element associated with this function |
*/ |
void set element(ExecutableElement element2) { |
@@ -6319,6 +7042,7 @@ class FunctionExpression extends Expression { |
/** |
* Set the parameters associated with the function to the given list of parameters. |
+ * |
* @param parameters the parameters associated with the function |
*/ |
void set parameters(FormalParameterList parameters2) { |
@@ -6332,10 +7056,15 @@ class FunctionExpression extends Expression { |
/** |
* Instances of the class `FunctionExpressionInvocation` represent the invocation of a |
* function resulting from evaluating an expression. Invocations of methods and other forms of |
- * functions are represented by [MethodInvocation method invocation] nodes. Invocations of |
- * getters and setters are represented by either [PrefixedIdentifier prefixed identifier] or[PropertyAccess property access] nodes. |
+ * functions are represented by [MethodInvocation] nodes. Invocations of |
+ * getters and setters are represented by either [PrefixedIdentifier] or |
+ * [PropertyAccess] nodes. |
+ * |
* <pre> |
- * functionExpressionInvoction ::=[Expression function] [ArgumentList argumentList]</pre> |
+ * functionExpressionInvoction ::= |
+ * [Expression] [ArgumentList] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class FunctionExpressionInvocation extends Expression { |
@@ -6351,17 +7080,20 @@ class FunctionExpressionInvocation extends Expression { |
ArgumentList _argumentList; |
/** |
- * The element associated with the function being invoked based on static type information, or`null` if the AST structure has not been resolved or the function could not be resolved. |
+ * The element associated with the function being invoked based on static type information, or |
+ * `null` if the AST structure has not been resolved or the function could not be resolved. |
*/ |
ExecutableElement _staticElement; |
/** |
- * The element associated with the function being invoked based on propagated type information, or`null` if the AST structure has not been resolved or the function could not be resolved. |
+ * The element associated with the function being invoked based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or the function could not be resolved. |
*/ |
ExecutableElement _propagatedElement; |
/** |
* Initialize a newly created function expression invocation. |
+ * |
* @param function the expression producing the function being invoked |
* @param argumentList the list of arguments to the method |
*/ |
@@ -6372,6 +7104,7 @@ class FunctionExpressionInvocation extends Expression { |
/** |
* Initialize a newly created function expression invocation. |
+ * |
* @param function the expression producing the function being invoked |
* @param argumentList the list of arguments to the method |
*/ |
@@ -6380,6 +7113,7 @@ class FunctionExpressionInvocation extends Expression { |
/** |
* Return the list of arguments to the method. |
+ * |
* @return the list of arguments to the method |
*/ |
ArgumentList get argumentList => _argumentList; |
@@ -6390,6 +7124,7 @@ class FunctionExpressionInvocation extends Expression { |
* information, or `null` if the AST structure has not been resolved or the function could |
* not be resolved. One common example of the latter case is an expression whose value can change |
* over time. |
+ * |
* @return the element associated with the function being invoked |
*/ |
ExecutableElement get element => _propagatedElement; |
@@ -6397,6 +7132,7 @@ class FunctionExpressionInvocation extends Expression { |
/** |
* Return the expression producing the function being invoked. |
+ * |
* @return the expression producing the function being invoked |
*/ |
Expression get function => _function; |
@@ -6406,12 +7142,14 @@ class FunctionExpressionInvocation extends Expression { |
* or `null` if the AST structure has not been resolved or the function could not be |
* resolved. One common example of the latter case is an expression whose value can change over |
* time. |
+ * |
* @return the element associated with the function |
*/ |
ExecutableElement get staticElement => _staticElement; |
/** |
* Set the list of arguments to the method to the given list. |
+ * |
* @param argumentList the list of arguments to the method |
*/ |
void set argumentList(ArgumentList argumentList2) { |
@@ -6421,6 +7159,7 @@ class FunctionExpressionInvocation extends Expression { |
/** |
* Set the element associated with the function being invoked based on propagated type information |
* to the given element. |
+ * |
* @param element the element to be associated with the function being invoked |
*/ |
void set element(ExecutableElement element2) { |
@@ -6429,6 +7168,7 @@ class FunctionExpressionInvocation extends Expression { |
/** |
* Set the expression producing the function being invoked to the given expression. |
+ * |
* @param function the expression producing the function being invoked |
*/ |
void set function(Expression function2) { |
@@ -6438,6 +7178,7 @@ class FunctionExpressionInvocation extends Expression { |
/** |
* Set the element associated with the function being invoked based on static type information to |
* the given element. |
+ * |
* @param element the element to be associated with the function |
*/ |
void set staticElement(ExecutableElement element) { |
@@ -6450,10 +7191,15 @@ class FunctionExpressionInvocation extends Expression { |
} |
/** |
* Instances of the class `FunctionTypeAlias` represent a function type alias. |
+ * |
* <pre> |
* functionTypeAlias ::= |
- * functionPrefix [TypeParameterList typeParameterList]? [FormalParameterList formalParameterList] ';' |
- * functionPrefix ::=[TypeName returnType]? [SimpleIdentifier name]</pre> |
+ * functionPrefix [TypeParameterList]? [FormalParameterList] ';' |
+ * |
+ * functionPrefix ::= |
+ * [TypeName]? [SimpleIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class FunctionTypeAlias extends TypeAlias { |
@@ -6482,6 +7228,7 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Initialize a newly created function type alias. |
+ * |
* @param comment the documentation comment associated with this type alias |
* @param metadata the annotations associated with this type alias |
* @param keyword the token representing the 'typedef' keyword |
@@ -6500,6 +7247,7 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Initialize a newly created function type alias. |
+ * |
* @param comment the documentation comment associated with this type alias |
* @param metadata the annotations associated with this type alias |
* @param keyword the token representing the 'typedef' keyword |
@@ -6515,12 +7263,14 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Return the name of the function type being declared. |
+ * |
* @return the name of the function type being declared |
*/ |
SimpleIdentifier get name => _name; |
/** |
* Return the parameters associated with the function type. |
+ * |
* @return the parameters associated with the function type |
*/ |
FormalParameterList get parameters => _parameters; |
@@ -6528,6 +7278,7 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Return the name of the return type of the function type being defined, or `null` if no |
* return type was given. |
+ * |
* @return the name of the return type of the function type being defined |
*/ |
TypeName get returnType => _returnType; |
@@ -6535,12 +7286,14 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Return the type parameters for the function type, or `null` if the function type does not |
* have any type parameters. |
+ * |
* @return the type parameters for the function type |
*/ |
TypeParameterList get typeParameters => _typeParameters; |
/** |
* Set the name of the function type being declared to the given identifier. |
+ * |
* @param name the name of the function type being declared |
*/ |
void set name(SimpleIdentifier name2) { |
@@ -6549,6 +7302,7 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Set the parameters associated with the function type to the given list of parameters. |
+ * |
* @param parameters the parameters associated with the function type |
*/ |
void set parameters(FormalParameterList parameters2) { |
@@ -6557,6 +7311,7 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Set the name of the return type of the function type being defined to the given type name. |
+ * |
* @param typeName the name of the return type of the function type being defined |
*/ |
void set returnType(TypeName typeName) { |
@@ -6565,6 +7320,7 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Set the type parameters for the function type to the given list of parameters. |
+ * |
* @param typeParameters the type parameters for the function type |
*/ |
void set typeParameters(TypeParameterList typeParameters2) { |
@@ -6581,8 +7337,12 @@ class FunctionTypeAlias extends TypeAlias { |
/** |
* Instances of the class `FunctionTypedFormalParameter` represent a function-typed formal |
* parameter. |
+ * |
* <pre> |
- * functionSignature ::=[TypeName returnType]? [SimpleIdentifier identifier] [FormalParameterList formalParameterList]</pre> |
+ * functionSignature ::= |
+ * [TypeName]? [SimpleIdentifier] [FormalParameterList] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class FunctionTypedFormalParameter extends NormalFormalParameter { |
@@ -6599,10 +7359,11 @@ class FunctionTypedFormalParameter extends NormalFormalParameter { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param returnType the return type of the function, or `null` if the function does not |
- * have a return type |
+ * have a return type |
* @param identifier the name of the function-typed parameter |
* @param parameters the parameters of the function-typed parameter |
*/ |
@@ -6613,10 +7374,11 @@ class FunctionTypedFormalParameter extends NormalFormalParameter { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param returnType the return type of the function, or `null` if the function does not |
- * have a return type |
+ * have a return type |
* @param identifier the name of the function-typed parameter |
* @param parameters the parameters of the function-typed parameter |
*/ |
@@ -6632,6 +7394,7 @@ class FunctionTypedFormalParameter extends NormalFormalParameter { |
/** |
* Return the parameters of the function-typed parameter. |
+ * |
* @return the parameters of the function-typed parameter |
*/ |
FormalParameterList get parameters => _parameters; |
@@ -6639,6 +7402,7 @@ class FunctionTypedFormalParameter extends NormalFormalParameter { |
/** |
* Return the return type of the function, or `null` if the function does not have a return |
* type. |
+ * |
* @return the return type of the function |
*/ |
TypeName get returnType => _returnType; |
@@ -6647,6 +7411,7 @@ class FunctionTypedFormalParameter extends NormalFormalParameter { |
/** |
* Set the parameters of the function-typed parameter to the given parameters. |
+ * |
* @param parameters the parameters of the function-typed parameter |
*/ |
void set parameters(FormalParameterList parameters2) { |
@@ -6655,6 +7420,7 @@ class FunctionTypedFormalParameter extends NormalFormalParameter { |
/** |
* Set the return type of the function to the given type. |
+ * |
* @param returnType the return type of the function |
*/ |
void set returnType(TypeName returnType2) { |
@@ -6670,10 +7436,12 @@ class FunctionTypedFormalParameter extends NormalFormalParameter { |
/** |
* Instances of the class `HideCombinator` represent a combinator that restricts the names |
* being imported to those that are not in a given list. |
+ * |
* <pre> |
* hideCombinator ::= |
- * 'hide' [SimpleIdentifier identifier] (',' [SimpleIdentifier identifier]) |
+ * 'hide' [SimpleIdentifier] (',' [SimpleIdentifier])* |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class HideCombinator extends Combinator { |
@@ -6685,6 +7453,7 @@ class HideCombinator extends Combinator { |
/** |
* Initialize a newly created import show combinator. |
+ * |
* @param keyword the comma introducing the combinator |
* @param hiddenNames the list of names from the library that are hidden by this combinator |
*/ |
@@ -6695,6 +7464,7 @@ class HideCombinator extends Combinator { |
/** |
* Initialize a newly created import show combinator. |
+ * |
* @param keyword the comma introducing the combinator |
* @param hiddenNames the list of names from the library that are hidden by this combinator |
*/ |
@@ -6704,6 +7474,7 @@ class HideCombinator extends Combinator { |
/** |
* Return the list of names from the library that are hidden by this combinator. |
+ * |
* @return the list of names from the library that are hidden by this combinator |
*/ |
NodeList<SimpleIdentifier> get hiddenNames => _hiddenNames; |
@@ -6714,8 +7485,13 @@ class HideCombinator extends Combinator { |
/** |
* The abstract class `Identifier` defines the behavior common to nodes that represent an |
* identifier. |
+ * |
* <pre> |
- * identifier ::=[SimpleIdentifier simpleIdentifier]| [PrefixedIdentifier prefixedIdentifier]</pre> |
+ * identifier ::= |
+ * [SimpleIdentifier] |
+ * | [PrefixedIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class Identifier extends Expression { |
@@ -6723,29 +7499,35 @@ abstract class Identifier extends Expression { |
/** |
* Return `true` if the given name is visible only within the library in which it is |
* declared. |
+ * |
* @param name the name being tested |
* @return `true` if the given name is private |
*/ |
static bool isPrivateName(String name) => name.startsWith("_"); |
/** |
- * Return the element associated with this identifier based on propagated type information, or`null` if the AST structure has not been resolved or if this identifier could not be |
+ * Return the element associated with this identifier based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or if this identifier could not be |
* resolved. One example of the latter case is an identifier that is not defined within the scope |
* in which it appears. |
+ * |
* @return the element associated with this identifier |
*/ |
Element get element; |
/** |
* Return the lexical representation of the identifier. |
+ * |
* @return the lexical representation of the identifier |
*/ |
String get name; |
/** |
- * Return the element associated with this identifier based on static type information, or`null` if the AST structure has not been resolved or if this identifier could not be |
+ * Return the element associated with this identifier based on static type information, or |
+ * `null` if the AST structure has not been resolved or if this identifier could not be |
* resolved. One example of the latter case is an identifier that is not defined within the scope |
* in which it appears |
+ * |
* @return the element associated with the operator |
*/ |
Element get staticElement; |
@@ -6753,10 +7535,12 @@ abstract class Identifier extends Expression { |
} |
/** |
* Instances of the class `IfStatement` represent an if statement. |
+ * |
* <pre> |
* ifStatement ::= |
- * 'if' '(' [Expression expression] ')' [Statement thenStatement] ('else' [Statement elseStatement])? |
+ * 'if' '(' [Expression] ')' [Statement] ('else' [Statement])? |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class IfStatement extends Statement { |
@@ -6799,6 +7583,7 @@ class IfStatement extends Statement { |
/** |
* Initialize a newly created if statement. |
+ * |
* @param ifKeyword the token representing the 'if' keyword |
* @param leftParenthesis the left parenthesis |
* @param condition the condition used to determine which of the statements is executed next |
@@ -6819,6 +7604,7 @@ class IfStatement extends Statement { |
/** |
* Initialize a newly created if statement. |
+ * |
* @param ifKeyword the token representing the 'if' keyword |
* @param leftParenthesis the left parenthesis |
* @param condition the condition used to determine which of the statements is executed next |
@@ -6833,18 +7619,22 @@ class IfStatement extends Statement { |
/** |
* Return the condition used to determine which of the statements is executed next. |
+ * |
* @return the condition used to determine which statement is executed next |
*/ |
Expression get condition => _condition; |
/** |
* Return the token representing the 'else' keyword. |
+ * |
* @return the token representing the 'else' keyword |
*/ |
Token get elseKeyword => _elseKeyword; |
/** |
- * Return the statement that is executed if the condition evaluates to `false`, or`null` if there is no else statement. |
+ * Return the statement that is executed if the condition evaluates to `false`, or |
+ * `null` if there is no else statement. |
+ * |
* @return the statement that is executed if the condition evaluates to `false` |
*/ |
Statement get elseStatement => _elseStatement; |
@@ -6857,24 +7647,28 @@ class IfStatement extends Statement { |
/** |
* Return the token representing the 'if' keyword. |
+ * |
* @return the token representing the 'if' keyword |
*/ |
Token get ifKeyword => _ifKeyword; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
* Return the statement that is executed if the condition evaluates to `true`. |
+ * |
* @return the statement that is executed if the condition evaluates to `true` |
*/ |
Statement get thenStatement => _thenStatement; |
@@ -6882,6 +7676,7 @@ class IfStatement extends Statement { |
/** |
* Set the condition used to determine which of the statements is executed next to the given |
* expression. |
+ * |
* @param expression the condition used to determine which statement is executed next |
*/ |
void set condition(Expression expression) { |
@@ -6890,6 +7685,7 @@ class IfStatement extends Statement { |
/** |
* Set the token representing the 'else' keyword to the given token. |
+ * |
* @param elseKeyword the token representing the 'else' keyword |
*/ |
void set elseKeyword(Token elseKeyword2) { |
@@ -6899,6 +7695,7 @@ class IfStatement extends Statement { |
/** |
* Set the statement that is executed if the condition evaluates to `false` to the given |
* statement. |
+ * |
* @param statement the statement that is executed if the condition evaluates to `false` |
*/ |
void set elseStatement(Statement statement) { |
@@ -6907,6 +7704,7 @@ class IfStatement extends Statement { |
/** |
* Set the token representing the 'if' keyword to the given token. |
+ * |
* @param ifKeyword the token representing the 'if' keyword |
*/ |
void set ifKeyword(Token ifKeyword2) { |
@@ -6915,6 +7713,7 @@ class IfStatement extends Statement { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param leftParenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token leftParenthesis2) { |
@@ -6923,6 +7722,7 @@ class IfStatement extends Statement { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param rightParenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token rightParenthesis2) { |
@@ -6932,6 +7732,7 @@ class IfStatement extends Statement { |
/** |
* Set the statement that is executed if the condition evaluates to `true` to the given |
* statement. |
+ * |
* @param statement the statement that is executed if the condition evaluates to `true` |
*/ |
void set thenStatement(Statement statement) { |
@@ -6946,10 +7747,12 @@ class IfStatement extends Statement { |
/** |
* Instances of the class `ImplementsClause` represent the "implements" clause in an class |
* declaration. |
+ * |
* <pre> |
* implementsClause ::= |
- * 'implements' [TypeName superclass] (',' [TypeName superclass]) |
+ * 'implements' [TypeName] (',' [TypeName])* |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ImplementsClause extends ASTNode { |
@@ -6966,6 +7769,7 @@ class ImplementsClause extends ASTNode { |
/** |
* Initialize a newly created extends clause. |
+ * |
* @param keyword the token representing the 'implements' keyword |
* @param interfaces the interfaces that are being implemented |
*/ |
@@ -6977,6 +7781,7 @@ class ImplementsClause extends ASTNode { |
/** |
* Initialize a newly created extends clause. |
+ * |
* @param keyword the token representing the 'implements' keyword |
* @param interfaces the interfaces that are being implemented |
*/ |
@@ -6987,18 +7792,21 @@ class ImplementsClause extends ASTNode { |
/** |
* Return the list of the interfaces that are being implemented. |
+ * |
* @return the list of the interfaces that are being implemented |
*/ |
NodeList<TypeName> get interfaces => _interfaces; |
/** |
* Return the token representing the 'implements' keyword. |
+ * |
* @return the token representing the 'implements' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Set the token representing the 'implements' keyword to the given token. |
+ * |
* @param keyword the token representing the 'implements' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -7010,9 +7818,12 @@ class ImplementsClause extends ASTNode { |
} |
/** |
* Instances of the class `ImportDirective` represent an import directive. |
+ * |
* <pre> |
- * importDirective ::=[Annotation metadata] 'import' [StringLiteral libraryUri] ('as' identifier)? [Combinator combinator]* ';' |
+ * importDirective ::= |
+ * [Annotation] 'import' [StringLiteral] ('as' identifier)? [Combinator]* ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ImportDirective extends NamespaceDirective { |
@@ -7030,6 +7841,7 @@ class ImportDirective extends NamespaceDirective { |
/** |
* Initialize a newly created import directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param keyword the token representing the 'import' keyword |
@@ -7046,6 +7858,7 @@ class ImportDirective extends NamespaceDirective { |
/** |
* Initialize a newly created import directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param keyword the token representing the 'import' keyword |
@@ -7061,6 +7874,7 @@ class ImportDirective extends NamespaceDirective { |
/** |
* Return the token representing the 'as' token, or `null` if the imported names are not |
* prefixed. |
+ * |
* @return the token representing the 'as' token |
*/ |
Token get asToken => _asToken; |
@@ -7068,6 +7882,7 @@ class ImportDirective extends NamespaceDirective { |
/** |
* Return the prefix to be used with the imported names, or `null` if the imported names are |
* not prefixed. |
+ * |
* @return the prefix to be used with the imported names |
*/ |
SimpleIdentifier get prefix => _prefix; |
@@ -7081,6 +7896,7 @@ class ImportDirective extends NamespaceDirective { |
/** |
* Set the token representing the 'as' token to the given token. |
+ * |
* @param asToken the token representing the 'as' token |
*/ |
void set asToken(Token asToken2) { |
@@ -7089,6 +7905,7 @@ class ImportDirective extends NamespaceDirective { |
/** |
* Set the prefix to be used with the imported names to the given identifier. |
+ * |
* @param prefix the prefix to be used with the imported names |
*/ |
void set prefix(SimpleIdentifier prefix2) { |
@@ -7102,9 +7919,12 @@ class ImportDirective extends NamespaceDirective { |
} |
/** |
* Instances of the class `IndexExpression` represent an index expression. |
+ * |
* <pre> |
- * indexExpression ::=[Expression target] '\[' [Expression index] '\]' |
+ * indexExpression ::= |
+ * [Expression] '[' [Expression] ']' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class IndexExpression extends Expression { |
@@ -7137,19 +7957,22 @@ class IndexExpression extends Expression { |
Token _rightBracket; |
/** |
- * The element associated with the operator based on the static type of the target, or`null` if the AST structure has not been resolved or if the operator could not be |
+ * The element associated with the operator based on the static type of the target, or |
+ * `null` if the AST structure has not been resolved or if the operator could not be |
* resolved. |
*/ |
MethodElement _staticElement; |
/** |
- * The element associated with the operator based on the propagated type of the target, or`null` if the AST structure has not been resolved or if the operator could not be |
+ * The element associated with the operator based on the propagated type of the target, or |
+ * `null` if the AST structure has not been resolved or if the operator could not be |
* resolved. |
*/ |
MethodElement _propagatedElement; |
/** |
* Initialize a newly created index expression. |
+ * |
* @param target the expression used to compute the object being indexed |
* @param leftBracket the left square bracket |
* @param index the expression used to compute the index |
@@ -7161,6 +7984,7 @@ class IndexExpression extends Expression { |
/** |
* Initialize a newly created index expression. |
+ * |
* @param target the expression used to compute the object being indexed |
* @param leftBracket the left square bracket |
* @param index the expression used to compute the index |
@@ -7176,6 +8000,7 @@ class IndexExpression extends Expression { |
/** |
* Initialize a newly created index expression. |
+ * |
* @param period the period ("..") before a cascaded index expression |
* @param leftBracket the left square bracket |
* @param index the expression used to compute the index |
@@ -7187,6 +8012,7 @@ class IndexExpression extends Expression { |
/** |
* Initialize a newly created index expression. |
+ * |
* @param period the period ("..") before a cascaded index expression |
* @param leftBracket the left square bracket |
* @param index the expression used to compute the index |
@@ -7204,6 +8030,7 @@ class IndexExpression extends Expression { |
/** |
* Return the expression used to compute the object being indexed, or `null` if this index |
* expression is part of a cascade expression. |
+ * |
* @return the expression used to compute the object being indexed |
* @see #getRealTarget() |
*/ |
@@ -7216,9 +8043,11 @@ class IndexExpression extends Expression { |
} |
/** |
- * Return the element associated with the operator based on the propagated type of the target, or`null` if the AST structure has not been resolved or if the operator could not be |
+ * Return the element associated with the operator based on the propagated type of the target, or |
+ * `null` if the AST structure has not been resolved or if the operator could not be |
* resolved. One example of the latter case is an operator that is not defined for the type of the |
* target. |
+ * |
* @return the element associated with this operator |
*/ |
MethodElement get element => _propagatedElement; |
@@ -7226,12 +8055,14 @@ class IndexExpression extends Expression { |
/** |
* Return the expression used to compute the index. |
+ * |
* @return the expression used to compute the index |
*/ |
Expression get index => _index; |
/** |
* Return the left square bracket. |
+ * |
* @return the left square bracket |
*/ |
Token get leftBracket => _leftBracket; |
@@ -7239,6 +8070,7 @@ class IndexExpression extends Expression { |
/** |
* Return the period ("..") before a cascaded index expression, or `null` if this index |
* expression is not part of a cascade expression. |
+ * |
* @return the period ("..") before a cascaded index expression |
*/ |
Token get period => _period; |
@@ -7248,6 +8080,7 @@ class IndexExpression extends Expression { |
* part of a cascade expression, then this is the same as [getArray]. If this index |
* expression is part of a cascade expression, then the target expression stored with the cascade |
* expression is returned. |
+ * |
* @return the expression used to compute the object being indexed |
* @see #getArray() |
*/ |
@@ -7267,14 +8100,17 @@ class IndexExpression extends Expression { |
/** |
* Return the right square bracket. |
+ * |
* @return the right square bracket |
*/ |
Token get rightBracket => _rightBracket; |
/** |
- * Return the element associated with the operator based on the static type of the target, or`null` if the AST structure has not been resolved or if the operator could not be |
+ * Return the element associated with the operator based on the static type of the target, or |
+ * `null` if the AST structure has not been resolved or if the operator could not be |
* resolved. One example of the latter case is an operator that is not defined for the type of the |
* target. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get staticElement => _staticElement; |
@@ -7283,8 +8119,10 @@ class IndexExpression extends Expression { |
* Return `true` if this expression is computing a right-hand value. |
* |
* Note that [inGetterContext] and [inSetterContext] are not opposites, nor are |
- * they mutually exclusive. In other words, it is possible for both methods to return `true`when invoked on the same node. |
- * @return `true` if this expression is in a context where the operator '\[\]' will be invoked |
+ * they mutually exclusive. In other words, it is possible for both methods to return `true` |
+ * when invoked on the same node. |
+ * |
+ * @return `true` if this expression is in a context where the operator '[]' will be invoked |
*/ |
bool inGetterContext() { |
ASTNode parent = this.parent; |
@@ -7301,9 +8139,11 @@ class IndexExpression extends Expression { |
* Return `true` if this expression is computing a left-hand value. |
* |
* Note that [inGetterContext] and [inSetterContext] are not opposites, nor are |
- * they mutually exclusive. In other words, it is possible for both methods to return `true`when invoked on the same node. |
- * @return `true` if this expression is in a context where the operator '\[\]=' will be |
- * invoked |
+ * they mutually exclusive. In other words, it is possible for both methods to return `true` |
+ * when invoked on the same node. |
+ * |
+ * @return `true` if this expression is in a context where the operator '[]=' will be |
+ * invoked |
*/ |
bool inSetterContext() { |
ASTNode parent = this.parent; |
@@ -7320,13 +8160,16 @@ class IndexExpression extends Expression { |
/** |
* Return `true` if this expression is cascaded. If it is, then the target of this |
- * expression is not stored locally but is stored in the nearest ancestor that is a[CascadeExpression]. |
+ * expression is not stored locally but is stored in the nearest ancestor that is a |
+ * [CascadeExpression]. |
+ * |
* @return `true` if this expression is cascaded |
*/ |
bool get isCascaded => _period != null; |
/** |
* Set the expression used to compute the object being indexed to the given expression. |
+ * |
* @param expression the expression used to compute the object being indexed |
*/ |
void set array(Expression expression) { |
@@ -7336,6 +8179,7 @@ class IndexExpression extends Expression { |
/** |
* Set the element associated with the operator based on the propagated type of the target to the |
* given element. |
+ * |
* @param element the element to be associated with this operator |
*/ |
void set element(MethodElement element2) { |
@@ -7344,6 +8188,7 @@ class IndexExpression extends Expression { |
/** |
* Set the expression used to compute the index to the given expression. |
+ * |
* @param expression the expression used to compute the index |
*/ |
void set index(Expression expression) { |
@@ -7352,6 +8197,7 @@ class IndexExpression extends Expression { |
/** |
* Set the left square bracket to the given token. |
+ * |
* @param bracket the left square bracket |
*/ |
void set leftBracket(Token bracket) { |
@@ -7360,6 +8206,7 @@ class IndexExpression extends Expression { |
/** |
* Set the period ("..") before a cascaded index expression to the given token. |
+ * |
* @param period the period ("..") before a cascaded index expression |
*/ |
void set period(Token period2) { |
@@ -7368,6 +8215,7 @@ class IndexExpression extends Expression { |
/** |
* Set the right square bracket to the given token. |
+ * |
* @param bracket the right square bracket |
*/ |
void set rightBracket(Token bracket) { |
@@ -7377,6 +8225,7 @@ class IndexExpression extends Expression { |
/** |
* Set the element associated with the operator based on the static type of the target to the |
* given element. |
+ * |
* @param element the static element to be associated with the operator |
*/ |
void set staticElement(MethodElement element) { |
@@ -7393,8 +8242,9 @@ class IndexExpression extends Expression { |
* which the value of the index expression will be bound. Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getParameterElement]. |
+ * |
* @return the parameter element representing the parameter to which the value of the index |
- * expression will be bound |
+ * expression will be bound |
*/ |
ParameterElement get propagatedParameterElementForIndex { |
if (_propagatedElement == null) { |
@@ -7413,8 +8263,9 @@ class IndexExpression extends Expression { |
* value of the index expression will be bound. Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getStaticParameterElement]. |
+ * |
* @return the parameter element representing the parameter to which the value of the index |
- * expression will be bound |
+ * expression will be bound |
*/ |
ParameterElement get staticParameterElementForIndex { |
if (_staticElement == null) { |
@@ -7430,9 +8281,12 @@ class IndexExpression extends Expression { |
/** |
* Instances of the class `InstanceCreationExpression` represent an instance creation |
* expression. |
+ * |
* <pre> |
* newExpression ::= |
- * ('new' | 'const') [TypeName type] ('.' [SimpleIdentifier identifier])? [ArgumentList argumentList]</pre> |
+ * ('new' | 'const') [TypeName] ('.' [SimpleIdentifier])? [ArgumentList] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class InstanceCreationExpression extends Expression { |
@@ -7453,18 +8307,21 @@ class InstanceCreationExpression extends Expression { |
ArgumentList _argumentList; |
/** |
- * The element associated with the constructor based on static type information, or `null`if the AST structure has not been resolved or if the constructor could not be resolved. |
+ * The element associated with the constructor based on static type information, or `null` |
+ * if the AST structure has not been resolved or if the constructor could not be resolved. |
*/ |
ConstructorElement _staticElement; |
/** |
- * The element associated with the constructor based on propagated type information, or`null` if the AST structure has not been resolved or if the constructor could not be |
+ * The element associated with the constructor based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or if the constructor could not be |
* resolved. |
*/ |
ConstructorElement _propagatedElement; |
/** |
* Initialize a newly created instance creation expression. |
+ * |
* @param keyword the keyword used to indicate how an object should be created |
* @param constructorName the name of the constructor to be invoked |
* @param argumentList the list of arguments to the constructor |
@@ -7477,6 +8334,7 @@ class InstanceCreationExpression extends Expression { |
/** |
* Initialize a newly created instance creation expression. |
+ * |
* @param keyword the keyword used to indicate how an object should be created |
* @param constructorName the name of the constructor to be invoked |
* @param argumentList the list of arguments to the constructor |
@@ -7486,6 +8344,7 @@ class InstanceCreationExpression extends Expression { |
/** |
* Return the list of arguments to the constructor. |
+ * |
* @return the list of arguments to the constructor |
*/ |
ArgumentList get argumentList => _argumentList; |
@@ -7493,13 +8352,16 @@ class InstanceCreationExpression extends Expression { |
/** |
* Return the name of the constructor to be invoked. |
+ * |
* @return the name of the constructor to be invoked |
*/ |
ConstructorName get constructorName => _constructorName; |
/** |
- * Return the element associated with the constructor based on propagated type information, or`null` if the AST structure has not been resolved or if the constructor could not be |
+ * Return the element associated with the constructor based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or if the constructor could not be |
* resolved. |
+ * |
* @return the element associated with the constructor |
*/ |
ConstructorElement get element => _propagatedElement; |
@@ -7507,25 +8369,30 @@ class InstanceCreationExpression extends Expression { |
/** |
* Return the keyword used to indicate how an object should be created. |
+ * |
* @return the keyword used to indicate how an object should be created |
*/ |
Token get keyword => _keyword; |
/** |
- * Return the element associated with the constructor based on static type information, or`null` if the AST structure has not been resolved or if the constructor could not be |
+ * Return the element associated with the constructor based on static type information, or |
+ * `null` if the AST structure has not been resolved or if the constructor could not be |
* resolved. |
+ * |
* @return the element associated with the constructor |
*/ |
ConstructorElement get staticElement => _staticElement; |
/** |
* Return `true` if this creation expression is used to invoke a constant constructor. |
+ * |
* @return `true` if this creation expression is used to invoke a constant constructor |
*/ |
bool get isConst => _keyword is KeywordToken && identical(((_keyword as KeywordToken)).keyword, Keyword.CONST); |
/** |
* Set the list of arguments to the constructor to the given list. |
+ * |
* @param argumentList the list of arguments to the constructor |
*/ |
void set argumentList(ArgumentList argumentList2) { |
@@ -7534,6 +8401,7 @@ class InstanceCreationExpression extends Expression { |
/** |
* Set the name of the constructor to be invoked to the given name. |
+ * |
* @param constructorName the name of the constructor to be invoked |
*/ |
void set constructorName(ConstructorName constructorName2) { |
@@ -7543,6 +8411,7 @@ class InstanceCreationExpression extends Expression { |
/** |
* Set the element associated with the constructor based on propagated type information to the |
* given element. |
+ * |
* @param element the element to be associated with the constructor |
*/ |
void set element(ConstructorElement element2) { |
@@ -7551,6 +8420,7 @@ class InstanceCreationExpression extends Expression { |
/** |
* Set the keyword used to indicate how an object should be created to the given keyword. |
+ * |
* @param keyword the keyword used to indicate how an object should be created |
*/ |
void set keyword(Token keyword2) { |
@@ -7560,6 +8430,7 @@ class InstanceCreationExpression extends Expression { |
/** |
* Set the element associated with the constructor based on static type information to the given |
* element. |
+ * |
* @param element the element to be associated with the constructor |
*/ |
void set staticElement(ConstructorElement element) { |
@@ -7572,16 +8443,20 @@ class InstanceCreationExpression extends Expression { |
} |
/** |
* Instances of the class `IntegerLiteral` represent an integer literal expression. |
+ * |
* <pre> |
* integerLiteral ::= |
- * decimalIntegerLiteral |
- * | hexidecimalIntegerLiteral |
+ * decimalIntegerLiteral |
+ * | hexidecimalIntegerLiteral |
+ * |
* decimalIntegerLiteral ::= |
- * decimalDigit+ |
+ * decimalDigit+ |
+ * |
* hexidecimalIntegerLiteral ::= |
- * '0x' hexidecimalDigit+ |
- * | '0X' hexidecimalDigit+ |
+ * '0x' hexidecimalDigit+ |
+ * | '0X' hexidecimalDigit+ |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class IntegerLiteral extends Literal { |
@@ -7598,6 +8473,7 @@ class IntegerLiteral extends Literal { |
/** |
* Initialize a newly created integer literal. |
+ * |
* @param literal the token representing the literal |
* @param value the value of the literal |
*/ |
@@ -7608,6 +8484,7 @@ class IntegerLiteral extends Literal { |
/** |
* Initialize a newly created integer literal. |
+ * |
* @param literal the token representing the literal |
* @param value the value of the literal |
*/ |
@@ -7618,18 +8495,21 @@ class IntegerLiteral extends Literal { |
/** |
* Return the token representing the literal. |
+ * |
* @return the token representing the literal |
*/ |
Token get literal => _literal; |
/** |
* Return the value of the literal. |
+ * |
* @return the value of the literal |
*/ |
int get value => _value; |
/** |
* Set the token representing the literal to the given token. |
+ * |
* @param literal the token representing the literal |
*/ |
void set literal(Token literal2) { |
@@ -7638,6 +8518,7 @@ class IntegerLiteral extends Literal { |
/** |
* Set the value of the literal to the given value. |
+ * |
* @param value the value of the literal |
*/ |
void set value(int value2) { |
@@ -7647,9 +8528,15 @@ class IntegerLiteral extends Literal { |
} |
} |
/** |
- * The abstract class `InterpolationElement` defines the behavior common to elements within a[StringInterpolation string interpolation]. |
+ * The abstract class `InterpolationElement` defines the behavior common to elements within a |
+ * [StringInterpolation]. |
+ * |
* <pre> |
- * interpolationElement ::=[InterpolationExpression interpolationExpression]| [InterpolationString interpolationString]</pre> |
+ * interpolationElement ::= |
+ * [InterpolationExpression] |
+ * | [InterpolationString] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class InterpolationElement extends ASTNode { |
@@ -7657,10 +8544,13 @@ abstract class InterpolationElement extends ASTNode { |
/** |
* Instances of the class `InterpolationExpression` represent an expression embedded in a |
* string interpolation. |
+ * |
* <pre> |
* interpolationExpression ::= |
- * '$' [SimpleIdentifier identifier]| '$' '{' [Expression expression] '}' |
+ * '$' [SimpleIdentifier] |
+ * | '$' '{' [Expression] '}' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class InterpolationExpression extends InterpolationElement { |
@@ -7683,6 +8573,7 @@ class InterpolationExpression extends InterpolationElement { |
/** |
* Initialize a newly created interpolation expression. |
+ * |
* @param leftBracket the left curly bracket |
* @param expression the expression to be evaluated for the value to be converted into a string |
* @param rightBracket the right curly bracket |
@@ -7695,6 +8586,7 @@ class InterpolationExpression extends InterpolationElement { |
/** |
* Initialize a newly created interpolation expression. |
+ * |
* @param leftBracket the left curly bracket |
* @param expression the expression to be evaluated for the value to be converted into a string |
* @param rightBracket the right curly bracket |
@@ -7711,18 +8603,21 @@ class InterpolationExpression extends InterpolationElement { |
/** |
* Return the expression to be evaluated for the value to be converted into a string. |
+ * |
* @return the expression to be evaluated for the value to be converted into a string |
*/ |
Expression get expression => _expression; |
/** |
* Return the left curly bracket. |
+ * |
* @return the left curly bracket |
*/ |
Token get leftBracket => _leftBracket; |
/** |
* Return the right curly bracket. |
+ * |
* @return the right curly bracket |
*/ |
Token get rightBracket => _rightBracket; |
@@ -7730,6 +8625,7 @@ class InterpolationExpression extends InterpolationElement { |
/** |
* Set the expression to be evaluated for the value to be converted into a string to the given |
* expression. |
+ * |
* @param expression the expression to be evaluated for the value to be converted into a string |
*/ |
void set expression(Expression expression2) { |
@@ -7738,6 +8634,7 @@ class InterpolationExpression extends InterpolationElement { |
/** |
* Set the left curly bracket to the given token. |
+ * |
* @param leftBracket the left curly bracket |
*/ |
void set leftBracket(Token leftBracket2) { |
@@ -7746,6 +8643,7 @@ class InterpolationExpression extends InterpolationElement { |
/** |
* Set the right curly bracket to the given token. |
+ * |
* @param rightBracket the right curly bracket |
*/ |
void set rightBracket(Token rightBracket2) { |
@@ -7758,10 +8656,12 @@ class InterpolationExpression extends InterpolationElement { |
/** |
* Instances of the class `InterpolationString` represent a non-empty substring of an |
* interpolated string. |
+ * |
* <pre> |
* interpolationString ::= |
- * characters |
+ * characters |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class InterpolationString extends InterpolationElement { |
@@ -7778,6 +8678,7 @@ class InterpolationString extends InterpolationElement { |
/** |
* Initialize a newly created string of characters that are part of a string interpolation. |
+ * |
* @param the characters that will be added to the string |
* @param value the value of the literal |
*/ |
@@ -7788,6 +8689,7 @@ class InterpolationString extends InterpolationElement { |
/** |
* Initialize a newly created string of characters that are part of a string interpolation. |
+ * |
* @param the characters that will be added to the string |
* @param value the value of the literal |
*/ |
@@ -7797,6 +8699,7 @@ class InterpolationString extends InterpolationElement { |
/** |
* Return the characters that will be added to the string. |
+ * |
* @return the characters that will be added to the string |
*/ |
Token get contents => _contents; |
@@ -7804,12 +8707,14 @@ class InterpolationString extends InterpolationElement { |
/** |
* Return the value of the literal. |
+ * |
* @return the value of the literal |
*/ |
String get value => _value; |
/** |
* Set the characters that will be added to the string to those in the given string. |
+ * |
* @param string the characters that will be added to the string |
*/ |
void set contents(Token string) { |
@@ -7818,6 +8723,7 @@ class InterpolationString extends InterpolationElement { |
/** |
* Set the value of the literal to the given string. |
+ * |
* @param string the value of the literal |
*/ |
void set value(String string) { |
@@ -7828,8 +8734,12 @@ class InterpolationString extends InterpolationElement { |
} |
/** |
* Instances of the class `IsExpression` represent an is expression. |
+ * |
* <pre> |
- * isExpression ::=[Expression expression] 'is' '!'? [TypeName type]</pre> |
+ * isExpression ::= |
+ * [Expression] 'is' '!'? [TypeName] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class IsExpression extends Expression { |
@@ -7856,6 +8766,7 @@ class IsExpression extends Expression { |
/** |
* Initialize a newly created is expression. |
+ * |
* @param expression the expression used to compute the value whose type is being tested |
* @param isOperator the is operator |
* @param notOperator the not operator, or `null` if the sense of the test is not negated |
@@ -7870,6 +8781,7 @@ class IsExpression extends Expression { |
/** |
* Initialize a newly created is expression. |
+ * |
* @param expression the expression used to compute the value whose type is being tested |
* @param isOperator the is operator |
* @param notOperator the not operator, or `null` if the sense of the test is not negated |
@@ -7882,24 +8794,28 @@ class IsExpression extends Expression { |
/** |
* Return the expression used to compute the value whose type is being tested. |
+ * |
* @return the expression used to compute the value whose type is being tested |
*/ |
Expression get expression => _expression; |
/** |
* Return the is operator being applied. |
+ * |
* @return the is operator being applied |
*/ |
Token get isOperator => _isOperator; |
/** |
* Return the not operator being applied. |
+ * |
* @return the not operator being applied |
*/ |
Token get notOperator => _notOperator; |
/** |
* Return the name of the type being tested for. |
+ * |
* @return the name of the type being tested for |
*/ |
TypeName get type => _type; |
@@ -7907,6 +8823,7 @@ class IsExpression extends Expression { |
/** |
* Set the expression used to compute the value whose type is being tested to the given |
* expression. |
+ * |
* @param expression the expression used to compute the value whose type is being tested |
*/ |
void set expression(Expression expression2) { |
@@ -7915,6 +8832,7 @@ class IsExpression extends Expression { |
/** |
* Set the is operator being applied to the given operator. |
+ * |
* @param isOperator the is operator being applied |
*/ |
void set isOperator(Token isOperator2) { |
@@ -7923,6 +8841,7 @@ class IsExpression extends Expression { |
/** |
* Set the not operator being applied to the given operator. |
+ * |
* @param notOperator the is operator being applied |
*/ |
void set notOperator(Token notOperator2) { |
@@ -7931,6 +8850,7 @@ class IsExpression extends Expression { |
/** |
* Set the name of the type being tested for to the given name. |
+ * |
* @param name the name of the type being tested for |
*/ |
void set type(TypeName name) { |
@@ -7943,9 +8863,12 @@ class IsExpression extends Expression { |
} |
/** |
* Instances of the class `Label` represent a label. |
+ * |
* <pre> |
- * label ::=[SimpleIdentifier label] ':' |
+ * label ::= |
+ * [SimpleIdentifier] ':' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class Label extends ASTNode { |
@@ -7962,6 +8885,7 @@ class Label extends ASTNode { |
/** |
* Initialize a newly created label. |
+ * |
* @param label the label being applied |
* @param colon the colon that separates the label from whatever follows |
*/ |
@@ -7972,6 +8896,7 @@ class Label extends ASTNode { |
/** |
* Initialize a newly created label. |
+ * |
* @param label the label being applied |
* @param colon the colon that separates the label from whatever follows |
*/ |
@@ -7981,6 +8906,7 @@ class Label extends ASTNode { |
/** |
* Return the colon that separates the label from the statement. |
+ * |
* @return the colon that separates the label from the statement |
*/ |
Token get colon => _colon; |
@@ -7988,12 +8914,14 @@ class Label extends ASTNode { |
/** |
* Return the label being associated with the statement. |
+ * |
* @return the label being associated with the statement |
*/ |
SimpleIdentifier get label => _label; |
/** |
* Set the colon that separates the label from the statement to the given token. |
+ * |
* @param colon the colon that separates the label from the statement |
*/ |
void set colon(Token colon2) { |
@@ -8002,6 +8930,7 @@ class Label extends ASTNode { |
/** |
* Set the label being associated with the statement to the given label. |
+ * |
* @param label the label being associated with the statement |
*/ |
void set label(SimpleIdentifier label2) { |
@@ -8014,8 +8943,12 @@ class Label extends ASTNode { |
/** |
* Instances of the class `LabeledStatement` represent a statement that has a label associated |
* with them. |
+ * |
* <pre> |
- * labeledStatement ::=[Label label]+ [Statement statement]</pre> |
+ * labeledStatement ::= |
+ * [Label]+ [Statement] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class LabeledStatement extends Statement { |
@@ -8032,6 +8965,7 @@ class LabeledStatement extends Statement { |
/** |
* Initialize a newly created labeled statement. |
+ * |
* @param labels the labels being associated with the statement |
* @param statement the statement with which the labels are being associated |
*/ |
@@ -8043,6 +8977,7 @@ class LabeledStatement extends Statement { |
/** |
* Initialize a newly created labeled statement. |
+ * |
* @param labels the labels being associated with the statement |
* @param statement the statement with which the labels are being associated |
*/ |
@@ -8058,18 +8993,21 @@ class LabeledStatement extends Statement { |
/** |
* Return the labels being associated with the statement. |
+ * |
* @return the labels being associated with the statement |
*/ |
NodeList<Label> get labels => _labels; |
/** |
* Return the statement with which the labels are being associated. |
+ * |
* @return the statement with which the labels are being associated |
*/ |
Statement get statement => _statement; |
/** |
* Set the statement with which the labels are being associated to the given statement. |
+ * |
* @param statement the statement with which the labels are being associated |
*/ |
void set statement(Statement statement2) { |
@@ -8082,9 +9020,12 @@ class LabeledStatement extends Statement { |
} |
/** |
* Instances of the class `LibraryDirective` represent a library directive. |
+ * |
* <pre> |
- * libraryDirective ::=[Annotation metadata] 'library' [Identifier name] ';' |
+ * libraryDirective ::= |
+ * [Annotation] 'library' [Identifier] ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class LibraryDirective extends Directive { |
@@ -8106,6 +9047,7 @@ class LibraryDirective extends Directive { |
/** |
* Initialize a newly created library directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param libraryToken the token representing the 'library' token |
@@ -8120,6 +9062,7 @@ class LibraryDirective extends Directive { |
/** |
* Initialize a newly created library directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param libraryToken the token representing the 'library' token |
@@ -8133,24 +9076,28 @@ class LibraryDirective extends Directive { |
/** |
* Return the token representing the 'library' token. |
+ * |
* @return the token representing the 'library' token |
*/ |
Token get libraryToken => _libraryToken; |
/** |
* Return the name of the library being defined. |
+ * |
* @return the name of the library being defined |
*/ |
LibraryIdentifier get name => _name; |
/** |
* Return the semicolon terminating the directive. |
+ * |
* @return the semicolon terminating the directive |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the token representing the 'library' token to the given token. |
+ * |
* @param libraryToken the token representing the 'library' token |
*/ |
void set libraryToken(Token libraryToken2) { |
@@ -8159,6 +9106,7 @@ class LibraryDirective extends Directive { |
/** |
* Set the name of the library being defined to the given name. |
+ * |
* @param name the name of the library being defined |
*/ |
void set name(LibraryIdentifier name2) { |
@@ -8167,6 +9115,7 @@ class LibraryDirective extends Directive { |
/** |
* Set the semicolon terminating the directive to the given token. |
+ * |
* @param semicolon the semicolon terminating the directive |
*/ |
void set semicolon(Token semicolon2) { |
@@ -8180,9 +9129,12 @@ class LibraryDirective extends Directive { |
} |
/** |
* Instances of the class `LibraryIdentifier` represent the identifier for a library. |
+ * |
* <pre> |
- * libraryIdentifier ::=[SimpleIdentifier component] ('.' [SimpleIdentifier component]) |
+ * libraryIdentifier ::= |
+ * [SimpleIdentifier] ('.' [SimpleIdentifier])* |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class LibraryIdentifier extends Identifier { |
@@ -8194,6 +9146,7 @@ class LibraryIdentifier extends Identifier { |
/** |
* Initialize a newly created prefixed identifier. |
+ * |
* @param components the components of the identifier |
*/ |
LibraryIdentifier.full(List<SimpleIdentifier> components) { |
@@ -8203,6 +9156,7 @@ class LibraryIdentifier extends Identifier { |
/** |
* Initialize a newly created prefixed identifier. |
+ * |
* @param components the components of the identifier |
*/ |
LibraryIdentifier({List<SimpleIdentifier> components}) : this.full(components); |
@@ -8211,6 +9165,7 @@ class LibraryIdentifier extends Identifier { |
/** |
* Return the components of the identifier. |
+ * |
* @return the components of the identifier |
*/ |
NodeList<SimpleIdentifier> get components => _components; |
@@ -8236,10 +9191,12 @@ class LibraryIdentifier extends Identifier { |
} |
/** |
* Instances of the class `ListLiteral` represent a list literal. |
+ * |
* <pre> |
* listLiteral ::= |
- * 'const'? ('<' [TypeName type] '>')? '\[' ([Expression expressionList] ','?)? '\]' |
+ * 'const'? ('<' [TypeName] '>')? '[' ([Expression] ','?)? ']' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ListLiteral extends TypedLiteral { |
@@ -8261,9 +9218,10 @@ class ListLiteral extends TypedLiteral { |
/** |
* Initialize a newly created list literal. |
+ * |
* @param modifier the const modifier associated with this literal |
* @param typeArguments the type argument associated with this literal, or `null` if no type |
- * arguments were declared |
+ * arguments were declared |
* @param leftBracket the left square bracket |
* @param elements the expressions used to compute the elements of the list |
* @param rightBracket the right square bracket |
@@ -8277,9 +9235,10 @@ class ListLiteral extends TypedLiteral { |
/** |
* Initialize a newly created list literal. |
+ * |
* @param modifier the const modifier associated with this literal |
* @param typeArguments the type argument associated with this literal, or `null` if no type |
- * arguments were declared |
+ * arguments were declared |
* @param leftBracket the left square bracket |
* @param elements the expressions used to compute the elements of the list |
* @param rightBracket the right square bracket |
@@ -8300,6 +9259,7 @@ class ListLiteral extends TypedLiteral { |
/** |
* Return the expressions used to compute the elements of the list. |
+ * |
* @return the expressions used to compute the elements of the list |
*/ |
NodeList<Expression> get elements => _elements; |
@@ -8307,18 +9267,21 @@ class ListLiteral extends TypedLiteral { |
/** |
* Return the left square bracket. |
+ * |
* @return the left square bracket |
*/ |
Token get leftBracket => _leftBracket; |
/** |
* Return the right square bracket. |
+ * |
* @return the right square bracket |
*/ |
Token get rightBracket => _rightBracket; |
/** |
* Set the left square bracket to the given token. |
+ * |
* @param bracket the left square bracket |
*/ |
void set leftBracket(Token bracket) { |
@@ -8327,6 +9290,7 @@ class ListLiteral extends TypedLiteral { |
/** |
* Set the right square bracket to the given token. |
+ * |
* @param bracket the right square bracket |
*/ |
void set rightBracket(Token bracket) { |
@@ -8340,18 +9304,30 @@ class ListLiteral extends TypedLiteral { |
/** |
* The abstract class `Literal` defines the behavior common to nodes that represent a literal |
* expression. |
+ * |
* <pre> |
- * literal ::=[BooleanLiteral booleanLiteral]| [DoubleLiteral doubleLiteral]| [IntegerLiteral integerLiteral]| [ListLiteral listLiteral]| [MapLiteral mapLiteral]| [NullLiteral nullLiteral]| [StringLiteral stringLiteral]</pre> |
+ * literal ::= |
+ * [BooleanLiteral] |
+ * | [DoubleLiteral] |
+ * | [IntegerLiteral] |
+ * | [ListLiteral] |
+ * | [MapLiteral] |
+ * | [NullLiteral] |
+ * | [StringLiteral] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class Literal extends Expression { |
} |
/** |
* Instances of the class `MapLiteral` represent a literal map. |
+ * |
* <pre> |
* mapLiteral ::= |
- * 'const'? ('<' [TypeName type] (',' [TypeName type])* '>')? '{' ([MapLiteralEntry entry] (',' [MapLiteralEntry entry])* ','?)? '}' |
+ * 'const'? ('<' [TypeName] (',' [TypeName])* '>')? '{' ([MapLiteralEntry] (',' [MapLiteralEntry])* ','?)? '}' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class MapLiteral extends TypedLiteral { |
@@ -8373,9 +9349,10 @@ class MapLiteral extends TypedLiteral { |
/** |
* Initialize a newly created map literal. |
+ * |
* @param modifier the const modifier associated with this literal |
* @param typeArguments the type argument associated with this literal, or `null` if no type |
- * arguments were declared |
+ * arguments were declared |
* @param leftBracket the left curly bracket |
* @param entries the entries in the map |
* @param rightBracket the right curly bracket |
@@ -8389,9 +9366,10 @@ class MapLiteral extends TypedLiteral { |
/** |
* Initialize a newly created map literal. |
+ * |
* @param modifier the const modifier associated with this literal |
* @param typeArguments the type argument associated with this literal, or `null` if no type |
- * arguments were declared |
+ * arguments were declared |
* @param leftBracket the left curly bracket |
* @param entries the entries in the map |
* @param rightBracket the right curly bracket |
@@ -8413,24 +9391,28 @@ class MapLiteral extends TypedLiteral { |
/** |
* Return the entries in the map. |
+ * |
* @return the entries in the map |
*/ |
NodeList<MapLiteralEntry> get entries => _entries; |
/** |
* Return the left curly bracket. |
+ * |
* @return the left curly bracket |
*/ |
Token get leftBracket => _leftBracket; |
/** |
* Return the right curly bracket. |
+ * |
* @return the right curly bracket |
*/ |
Token get rightBracket => _rightBracket; |
/** |
* Set the left curly bracket to the given token. |
+ * |
* @param bracket the left curly bracket |
*/ |
void set leftBracket(Token bracket) { |
@@ -8439,6 +9421,7 @@ class MapLiteral extends TypedLiteral { |
/** |
* Set the right curly bracket to the given token. |
+ * |
* @param bracket the right curly bracket |
*/ |
void set rightBracket(Token bracket) { |
@@ -8452,8 +9435,12 @@ class MapLiteral extends TypedLiteral { |
/** |
* Instances of the class `MapLiteralEntry` represent a single key/value pair in a map |
* literal. |
+ * |
* <pre> |
- * mapLiteralEntry ::=[Expression key] ':' [Expression value]</pre> |
+ * mapLiteralEntry ::= |
+ * [Expression] ':' [Expression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class MapLiteralEntry extends ASTNode { |
@@ -8475,6 +9462,7 @@ class MapLiteralEntry extends ASTNode { |
/** |
* Initialize a newly created map literal entry. |
+ * |
* @param key the expression computing the key with which the value will be associated |
* @param separator the colon that separates the key from the value |
* @param value the expression computing the value that will be associated with the key |
@@ -8487,6 +9475,7 @@ class MapLiteralEntry extends ASTNode { |
/** |
* Initialize a newly created map literal entry. |
+ * |
* @param key the expression computing the key with which the value will be associated |
* @param separator the colon that separates the key from the value |
* @param value the expression computing the value that will be associated with the key |
@@ -8498,18 +9487,21 @@ class MapLiteralEntry extends ASTNode { |
/** |
* Return the expression computing the key with which the value will be associated. |
+ * |
* @return the expression computing the key with which the value will be associated |
*/ |
Expression get key => _key; |
/** |
* Return the colon that separates the key from the value. |
+ * |
* @return the colon that separates the key from the value |
*/ |
Token get separator => _separator; |
/** |
* Return the expression computing the value that will be associated with the key. |
+ * |
* @return the expression computing the value that will be associated with the key |
*/ |
Expression get value => _value; |
@@ -8517,6 +9509,7 @@ class MapLiteralEntry extends ASTNode { |
/** |
* Set the expression computing the key with which the value will be associated to the given |
* string. |
+ * |
* @param string the expression computing the key with which the value will be associated |
*/ |
void set key(Expression string) { |
@@ -8525,6 +9518,7 @@ class MapLiteralEntry extends ASTNode { |
/** |
* Set the colon that separates the key from the value to the given token. |
+ * |
* @param separator the colon that separates the key from the value |
*/ |
void set separator(Token separator2) { |
@@ -8534,6 +9528,7 @@ class MapLiteralEntry extends ASTNode { |
/** |
* Set the expression computing the value that will be associated with the key to the given |
* expression. |
+ * |
* @param expression the expression computing the value that will be associated with the key |
*/ |
void set value(Expression expression) { |
@@ -8546,10 +9541,20 @@ class MapLiteralEntry extends ASTNode { |
} |
/** |
* Instances of the class `MethodDeclaration` represent a method declaration. |
+ * |
* <pre> |
* methodDeclaration ::= |
- * methodSignature [FunctionBody body]methodSignature ::= |
- * 'external'? ('abstract' | 'static')? [Type returnType]? ('get' | 'set')? methodName[FormalParameterList formalParameterList]methodName ::=[SimpleIdentifier name]| 'operator' [SimpleIdentifier operator]</pre> |
+ * methodSignature [FunctionBody] |
+ * |
+ * methodSignature ::= |
+ * 'external'? ('abstract' | 'static')? [Type]? ('get' | 'set')? methodName |
+ * [FormalParameterList] |
+ * |
+ * methodName ::= |
+ * [SimpleIdentifier] |
+ * | 'operator' [SimpleIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class MethodDeclaration extends ClassMember { |
@@ -8599,6 +9604,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Initialize a newly created method declaration. |
+ * |
* @param externalKeyword the token for the 'external' keyword |
* @param comment the documentation comment associated with this method |
* @param metadata the annotations associated with this method |
@@ -8608,7 +9614,7 @@ class MethodDeclaration extends ClassMember { |
* @param operatorKeyword the token representing the 'operator' keyword |
* @param name the name of the method |
* @param parameters the parameters associated with the method, or `null` if this method |
- * declares a getter |
+ * declares a getter |
* @param body the body of the method |
*/ |
MethodDeclaration.full(Comment comment, List<Annotation> metadata, Token externalKeyword, Token modifierKeyword, TypeName returnType, Token propertyKeyword, Token operatorKeyword, SimpleIdentifier name, FormalParameterList parameters, FunctionBody body) : super.full(comment, metadata) { |
@@ -8624,6 +9630,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Initialize a newly created method declaration. |
+ * |
* @param externalKeyword the token for the 'external' keyword |
* @param comment the documentation comment associated with this method |
* @param metadata the annotations associated with this method |
@@ -8633,7 +9640,7 @@ class MethodDeclaration extends ClassMember { |
* @param operatorKeyword the token representing the 'operator' keyword |
* @param name the name of the method |
* @param parameters the parameters associated with the method, or `null` if this method |
- * declares a getter |
+ * declares a getter |
* @param body the body of the method |
*/ |
MethodDeclaration({Comment comment, List<Annotation> metadata, Token externalKeyword, Token modifierKeyword, TypeName returnType, Token propertyKeyword, Token operatorKeyword, SimpleIdentifier name, FormalParameterList parameters, FunctionBody body}) : this.full(comment, metadata, externalKeyword, modifierKeyword, returnType, propertyKeyword, operatorKeyword, name, parameters, body); |
@@ -8641,6 +9648,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Return the body of the method. |
+ * |
* @return the body of the method |
*/ |
FunctionBody get body => _body; |
@@ -8650,6 +9658,7 @@ class MethodDeclaration extends ClassMember { |
* been resolved. The element can either be a [MethodElement], if this represents the |
* declaration of a normal method, or a [PropertyAccessorElement] if this represents the |
* declaration of either a getter or a setter. |
+ * |
* @return the element associated with this method |
*/ |
ExecutableElement get element => _name != null ? (_name.element as ExecutableElement) : null; |
@@ -8658,6 +9667,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Return the token for the 'external' keyword, or `null` if the constructor is not |
* external. |
+ * |
* @return the token for the 'external' keyword |
*/ |
Token get externalKeyword => _externalKeyword; |
@@ -8665,12 +9675,14 @@ class MethodDeclaration extends ClassMember { |
/** |
* Return the token representing the 'abstract' or 'static' keyword, or `null` if neither |
* modifier was specified. |
+ * |
* @return the token representing the 'abstract' or 'static' keyword |
*/ |
Token get modifierKeyword => _modifierKeyword; |
/** |
* Return the name of the method. |
+ * |
* @return the name of the method |
*/ |
SimpleIdentifier get name => _name; |
@@ -8678,6 +9690,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Return the token representing the 'operator' keyword, or `null` if this method does not |
* declare an operator. |
+ * |
* @return the token representing the 'operator' keyword |
*/ |
Token get operatorKeyword => _operatorKeyword; |
@@ -8685,6 +9698,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Return the parameters associated with the method, or `null` if this method declares a |
* getter. |
+ * |
* @return the parameters associated with the method |
*/ |
FormalParameterList get parameters => _parameters; |
@@ -8692,48 +9706,56 @@ class MethodDeclaration extends ClassMember { |
/** |
* Return the token representing the 'get' or 'set' keyword, or `null` if this is a method |
* declaration rather than a property declaration. |
+ * |
* @return the token representing the 'get' or 'set' keyword |
*/ |
Token get propertyKeyword => _propertyKeyword; |
/** |
* Return the return type of the method, or `null` if no return type was declared. |
+ * |
* @return the return type of the method |
*/ |
TypeName get returnType => _returnType; |
/** |
* Return `true` if this method is declared to be an abstract method. |
+ * |
* @return `true` if this method is declared to be an abstract method |
*/ |
bool get isAbstract => _externalKeyword == null && (_body is EmptyFunctionBody); |
/** |
* Return `true` if this method declares a getter. |
+ * |
* @return `true` if this method declares a getter |
*/ |
bool get isGetter => _propertyKeyword != null && identical(((_propertyKeyword as KeywordToken)).keyword, Keyword.GET); |
/** |
* Return `true` if this method declares an operator. |
+ * |
* @return `true` if this method declares an operator |
*/ |
bool get isOperator => _operatorKeyword != null; |
/** |
* Return `true` if this method declares a setter. |
+ * |
* @return `true` if this method declares a setter |
*/ |
bool get isSetter => _propertyKeyword != null && identical(((_propertyKeyword as KeywordToken)).keyword, Keyword.SET); |
/** |
* Return `true` if this method is declared to be a static method. |
+ * |
* @return `true` if this method is declared to be a static method |
*/ |
bool get isStatic => _modifierKeyword != null && identical(((_modifierKeyword as KeywordToken)).keyword, Keyword.STATIC); |
/** |
* Set the body of the method to the given function body. |
+ * |
* @param functionBody the body of the method |
*/ |
void set body(FunctionBody functionBody) { |
@@ -8742,6 +9764,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Set the token for the 'external' keyword to the given token. |
+ * |
* @param externalKeyword the token for the 'external' keyword |
*/ |
void set externalKeyword(Token externalKeyword2) { |
@@ -8750,6 +9773,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Set the token representing the 'abstract' or 'static' keyword to the given token. |
+ * |
* @param modifierKeyword the token representing the 'abstract' or 'static' keyword |
*/ |
void set modifierKeyword(Token modifierKeyword2) { |
@@ -8758,6 +9782,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Set the name of the method to the given identifier. |
+ * |
* @param identifier the name of the method |
*/ |
void set name(SimpleIdentifier identifier) { |
@@ -8766,6 +9791,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Set the token representing the 'operator' keyword to the given token. |
+ * |
* @param operatorKeyword the token representing the 'operator' keyword |
*/ |
void set operatorKeyword(Token operatorKeyword2) { |
@@ -8774,6 +9800,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Set the parameters associated with the method to the given list of parameters. |
+ * |
* @param parameters the parameters associated with the method |
*/ |
void set parameters(FormalParameterList parameters2) { |
@@ -8782,6 +9809,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Set the token representing the 'get' or 'set' keyword to the given token. |
+ * |
* @param propertyKeyword the token representing the 'get' or 'set' keyword |
*/ |
void set propertyKeyword(Token propertyKeyword2) { |
@@ -8790,6 +9818,7 @@ class MethodDeclaration extends ClassMember { |
/** |
* Set the return type of the method to the given type name. |
+ * |
* @param typeName the return type of the method |
*/ |
void set returnType(TypeName typeName) { |
@@ -8817,11 +9846,16 @@ class MethodDeclaration extends ClassMember { |
} |
/** |
* Instances of the class `MethodInvocation` represent the invocation of either a function or |
- * a method. Invocations of functions resulting from evaluating an expression are represented by[FunctionExpressionInvocation function expression invocation] nodes. Invocations of getters |
- * and setters are represented by either [PrefixedIdentifier prefixed identifier] or[PropertyAccess property access] nodes. |
+ * a method. Invocations of functions resulting from evaluating an expression are represented by |
+ * [FunctionExpressionInvocation] nodes. Invocations of getters |
+ * and setters are represented by either [PrefixedIdentifier] or |
+ * [PropertyAccess] nodes. |
+ * |
* <pre> |
* methodInvoction ::= |
- * ([Expression target] '.')? [SimpleIdentifier methodName] [ArgumentList argumentList]</pre> |
+ * ([Expression] '.')? [SimpleIdentifier] [ArgumentList] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class MethodInvocation extends Expression { |
@@ -8850,6 +9884,7 @@ class MethodInvocation extends Expression { |
/** |
* Initialize a newly created method invocation. |
+ * |
* @param target the expression producing the object on which the method is defined |
* @param period the period that separates the target from the method name |
* @param methodName the name of the method being invoked |
@@ -8864,6 +9899,7 @@ class MethodInvocation extends Expression { |
/** |
* Initialize a newly created method invocation. |
+ * |
* @param target the expression producing the object on which the method is defined |
* @param period the period that separates the target from the method name |
* @param methodName the name of the method being invoked |
@@ -8874,6 +9910,7 @@ class MethodInvocation extends Expression { |
/** |
* Return the list of arguments to the method. |
+ * |
* @return the list of arguments to the method |
*/ |
ArgumentList get argumentList => _argumentList; |
@@ -8889,6 +9926,7 @@ class MethodInvocation extends Expression { |
/** |
* Return the name of the method being invoked. |
+ * |
* @return the name of the method being invoked |
*/ |
SimpleIdentifier get methodName => _methodName; |
@@ -8896,6 +9934,7 @@ class MethodInvocation extends Expression { |
/** |
* Return the period that separates the target from the method name, or `null` if there is |
* no target. |
+ * |
* @return the period that separates the target from the method name |
*/ |
Token get period => _period; |
@@ -8905,6 +9944,7 @@ class MethodInvocation extends Expression { |
* part of a cascade expression, then this is the same as [getTarget]. If this invocation |
* is part of a cascade expression, then the target stored with the cascade expression is |
* returned. |
+ * |
* @return the expression used to compute the receiver of the invocation |
* @see #getTarget() |
*/ |
@@ -8926,6 +9966,7 @@ class MethodInvocation extends Expression { |
* Return the expression producing the object on which the method is defined, or `null` if |
* there is no target (that is, the target is implicitly `this`) or if this method |
* invocation is part of a cascade expression. |
+ * |
* @return the expression producing the object on which the method is defined |
* @see #getRealTarget() |
*/ |
@@ -8933,13 +9974,16 @@ class MethodInvocation extends Expression { |
/** |
* Return `true` if this expression is cascaded. If it is, then the target of this |
- * expression is not stored locally but is stored in the nearest ancestor that is a[CascadeExpression]. |
+ * expression is not stored locally but is stored in the nearest ancestor that is a |
+ * [CascadeExpression]. |
+ * |
* @return `true` if this expression is cascaded |
*/ |
bool get isCascaded => _period != null && identical(_period.type, TokenType.PERIOD_PERIOD); |
/** |
* Set the list of arguments to the method to the given list. |
+ * |
* @param argumentList the list of arguments to the method |
*/ |
void set argumentList(ArgumentList argumentList2) { |
@@ -8948,6 +9992,7 @@ class MethodInvocation extends Expression { |
/** |
* Set the name of the method being invoked to the given identifier. |
+ * |
* @param identifier the name of the method being invoked |
*/ |
void set methodName(SimpleIdentifier identifier) { |
@@ -8956,6 +10001,7 @@ class MethodInvocation extends Expression { |
/** |
* Set the period that separates the target from the method name to the given token. |
+ * |
* @param period the period that separates the target from the method name |
*/ |
void set period(Token period2) { |
@@ -8964,6 +10010,7 @@ class MethodInvocation extends Expression { |
/** |
* Set the expression producing the object on which the method is defined to the given expression. |
+ * |
* @param expression the expression producing the object on which the method is defined |
*/ |
void set target(Expression expression) { |
@@ -8978,8 +10025,12 @@ class MethodInvocation extends Expression { |
/** |
* Instances of the class `NamedExpression` represent an expression that has a name associated |
* with it. They are used in method invocations when there are named parameters. |
+ * |
* <pre> |
- * namedExpression ::=[Label name] [Expression expression]</pre> |
+ * namedExpression ::= |
+ * [Label] [Expression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class NamedExpression extends Expression { |
@@ -8996,6 +10047,7 @@ class NamedExpression extends Expression { |
/** |
* Initialize a newly created named expression. |
+ * |
* @param name the name associated with the expression |
* @param expression the expression with which the name is associated |
*/ |
@@ -9006,6 +10058,7 @@ class NamedExpression extends Expression { |
/** |
* Initialize a newly created named expression. |
+ * |
* @param name the name associated with the expression |
* @param expression the expression with which the name is associated |
*/ |
@@ -9014,8 +10067,10 @@ class NamedExpression extends Expression { |
Token get beginToken => _name.beginToken; |
/** |
- * Return the element representing the parameter being named by this expression, or `null`if the AST structure has not been resolved or if there is no parameter with the same name as |
+ * Return the element representing the parameter being named by this expression, or `null` |
+ * if the AST structure has not been resolved or if there is no parameter with the same name as |
* this expression. |
+ * |
* @return the element representing the parameter being named by this expression |
*/ |
ParameterElement get element { |
@@ -9029,18 +10084,21 @@ class NamedExpression extends Expression { |
/** |
* Return the expression with which the name is associated. |
+ * |
* @return the expression with which the name is associated |
*/ |
Expression get expression => _expression; |
/** |
* Return the name associated with the expression. |
+ * |
* @return the name associated with the expression |
*/ |
Label get name => _name; |
/** |
* Set the expression with which the name is associated to the given expression. |
+ * |
* @param expression the expression with which the name is associated |
*/ |
void set expression(Expression expression2) { |
@@ -9049,6 +10107,7 @@ class NamedExpression extends Expression { |
/** |
* Set the name associated with the expression to the given identifier. |
+ * |
* @param identifier the name associated with the expression |
*/ |
void set name(Label identifier) { |
@@ -9062,8 +10121,13 @@ class NamedExpression extends Expression { |
/** |
* The abstract class `NamespaceDirective` defines the behavior common to nodes that represent |
* a directive that impacts the namespace of a library. |
+ * |
* <pre> |
- * directive ::=[ExportDirective exportDirective]| [ImportDirective importDirective]</pre> |
+ * directive ::= |
+ * [ExportDirective] |
+ * | [ImportDirective] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class NamespaceDirective extends UriBasedDirective { |
@@ -9085,6 +10149,7 @@ abstract class NamespaceDirective extends UriBasedDirective { |
/** |
* Initialize a newly created namespace directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param keyword the token representing the 'import' or 'export' keyword |
@@ -9101,6 +10166,7 @@ abstract class NamespaceDirective extends UriBasedDirective { |
/** |
* Initialize a newly created namespace directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param keyword the token representing the 'import' or 'export' keyword |
@@ -9112,6 +10178,7 @@ abstract class NamespaceDirective extends UriBasedDirective { |
/** |
* Return the combinators used to control how names are imported or exported. |
+ * |
* @return the combinators used to control how names are imported or exported |
*/ |
NodeList<Combinator> get combinators => _combinators; |
@@ -9120,6 +10187,7 @@ abstract class NamespaceDirective extends UriBasedDirective { |
/** |
* Return the semicolon terminating the directive. |
+ * |
* @return the semicolon terminating the directive |
*/ |
Token get semicolon => _semicolon; |
@@ -9127,6 +10195,7 @@ abstract class NamespaceDirective extends UriBasedDirective { |
/** |
* Set the token representing the 'import' or 'export' keyword to the given token. |
+ * |
* @param exportToken the token representing the 'import' or 'export' keyword |
*/ |
void set keyword(Token exportToken) { |
@@ -9135,6 +10204,7 @@ abstract class NamespaceDirective extends UriBasedDirective { |
/** |
* Set the semicolon terminating the directive to the given token. |
+ * |
* @param semicolon the semicolon terminating the directive |
*/ |
void set semicolon(Token semicolon2) { |
@@ -9145,10 +10215,12 @@ abstract class NamespaceDirective extends UriBasedDirective { |
/** |
* Instances of the class `NativeFunctionBody` represent a function body that consists of a |
* native keyword followed by a string literal. |
+ * |
* <pre> |
* nativeFunctionBody ::= |
- * 'native' [SimpleStringLiteral simpleStringLiteral] ';' |
+ * 'native' [SimpleStringLiteral] ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class NativeFunctionBody extends FunctionBody { |
@@ -9171,6 +10243,7 @@ class NativeFunctionBody extends FunctionBody { |
/** |
* Initialize a newly created function body consisting of the 'native' token, a string literal, |
* and a semicolon. |
+ * |
* @param nativeToken the token representing 'native' that marks the start of the function body |
* @param stringLiteral the string literal |
* @param semicolon the token representing the semicolon that marks the end of the function body |
@@ -9184,6 +10257,7 @@ class NativeFunctionBody extends FunctionBody { |
/** |
* Initialize a newly created function body consisting of the 'native' token, a string literal, |
* and a semicolon. |
+ * |
* @param nativeToken the token representing 'native' that marks the start of the function body |
* @param stringLiteral the string literal |
* @param semicolon the token representing the semicolon that marks the end of the function body |
@@ -9195,18 +10269,21 @@ class NativeFunctionBody extends FunctionBody { |
/** |
* Return the simple identifier representing the 'native' token. |
+ * |
* @return the simple identifier representing the 'native' token |
*/ |
Token get nativeToken => _nativeToken; |
/** |
* Return the token representing the semicolon that marks the end of the function body. |
+ * |
* @return the token representing the semicolon that marks the end of the function body |
*/ |
Token get semicolon => _semicolon; |
/** |
* Return the string literal representing the string after the 'native' token. |
+ * |
* @return the string literal representing the string after the 'native' token |
*/ |
StringLiteral get stringLiteral => _stringLiteral; |
@@ -9217,8 +10294,14 @@ class NativeFunctionBody extends FunctionBody { |
/** |
* The abstract class `NormalFormalParameter` defines the behavior common to formal parameters |
* that are required (are not optional). |
+ * |
* <pre> |
- * normalFormalParameter ::=[FunctionTypedFormalParameter functionSignature]| [FieldFormalParameter fieldFormalParameter]| [SimpleFormalParameter simpleFormalParameter]</pre> |
+ * normalFormalParameter ::= |
+ * [FunctionTypedFormalParameter] |
+ * | [FieldFormalParameter] |
+ * | [SimpleFormalParameter] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class NormalFormalParameter extends FormalParameter { |
@@ -9241,6 +10324,7 @@ abstract class NormalFormalParameter extends FormalParameter { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param identifier the name of the parameter being declared |
@@ -9254,6 +10338,7 @@ abstract class NormalFormalParameter extends FormalParameter { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param identifier the name of the parameter being declared |
@@ -9263,6 +10348,7 @@ abstract class NormalFormalParameter extends FormalParameter { |
/** |
* Return the documentation comment associated with this parameter, or `null` if this |
* parameter does not have a documentation comment associated with it. |
+ * |
* @return the documentation comment associated with this parameter |
*/ |
Comment get documentationComment => _comment; |
@@ -9277,12 +10363,14 @@ abstract class NormalFormalParameter extends FormalParameter { |
/** |
* Return the annotations associated with this parameter. |
+ * |
* @return the annotations associated with this parameter |
*/ |
NodeList<Annotation> get metadata => _metadata; |
/** |
* Return `true` if this parameter was declared with the 'const' modifier. |
+ * |
* @return `true` if this parameter was declared with the 'const' modifier |
*/ |
bool get isConst; |
@@ -9291,12 +10379,14 @@ abstract class NormalFormalParameter extends FormalParameter { |
* Return `true` if this parameter was declared with the 'final' modifier. Parameters that |
* are declared with the 'const' modifier will return `false` even though they are |
* implicitly final. |
+ * |
* @return `true` if this parameter was declared with the 'final' modifier |
*/ |
bool get isFinal; |
/** |
* Set the documentation comment associated with this parameter to the given comment |
+ * |
* @param comment the documentation comment to be associated with this parameter |
*/ |
void set documentationComment(Comment comment2) { |
@@ -9305,6 +10395,7 @@ abstract class NormalFormalParameter extends FormalParameter { |
/** |
* Set the name of the parameter being declared to the given identifier. |
+ * |
* @param identifier the name of the parameter being declared |
*/ |
void set identifier(SimpleIdentifier identifier2) { |
@@ -9323,6 +10414,7 @@ abstract class NormalFormalParameter extends FormalParameter { |
/** |
* Return `true` if the comment is lexically before any annotations. |
+ * |
* @return `true` if the comment is lexically before any annotations |
*/ |
bool commentIsBeforeAnnotations() { |
@@ -9336,8 +10428,9 @@ abstract class NormalFormalParameter extends FormalParameter { |
/** |
* Return an array containing the comment and annotations associated with this parameter, sorted |
* in lexical order. |
+ * |
* @return the comment and annotations associated with this parameter in the order in which they |
- * appeared in the original source |
+ * appeared in the original source |
*/ |
List<ASTNode> get sortedCommentAndAnnotations { |
List<ASTNode> childList = new List<ASTNode>(); |
@@ -9350,10 +10443,12 @@ abstract class NormalFormalParameter extends FormalParameter { |
} |
/** |
* Instances of the class `NullLiteral` represent a null literal expression. |
+ * |
* <pre> |
* nullLiteral ::= |
- * 'null' |
+ * 'null' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class NullLiteral extends Literal { |
@@ -9365,6 +10460,7 @@ class NullLiteral extends Literal { |
/** |
* Initialize a newly created null literal. |
+ * |
* @param token the token representing the literal |
*/ |
NullLiteral.full(Token token) { |
@@ -9373,6 +10469,7 @@ class NullLiteral extends Literal { |
/** |
* Initialize a newly created null literal. |
+ * |
* @param token the token representing the literal |
*/ |
NullLiteral({Token token}) : this.full(token); |
@@ -9382,12 +10479,14 @@ class NullLiteral extends Literal { |
/** |
* Return the token representing the literal. |
+ * |
* @return the token representing the literal |
*/ |
Token get literal => _literal; |
/** |
* Set the token representing the literal to the given token. |
+ * |
* @param literal the token representing the literal |
*/ |
void set literal(Token literal2) { |
@@ -9398,10 +10497,12 @@ class NullLiteral extends Literal { |
} |
/** |
* Instances of the class `ParenthesizedExpression` represent a parenthesized expression. |
+ * |
* <pre> |
* parenthesizedExpression ::= |
- * '(' [Expression expression] ')' |
+ * '(' [Expression] ')' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ParenthesizedExpression extends Expression { |
@@ -9423,6 +10524,7 @@ class ParenthesizedExpression extends Expression { |
/** |
* Initialize a newly created parenthesized expression. |
+ * |
* @param leftParenthesis the left parenthesis |
* @param expression the expression within the parentheses |
* @param rightParenthesis the right parenthesis |
@@ -9435,6 +10537,7 @@ class ParenthesizedExpression extends Expression { |
/** |
* Initialize a newly created parenthesized expression. |
+ * |
* @param leftParenthesis the left parenthesis |
* @param expression the expression within the parentheses |
* @param rightParenthesis the right parenthesis |
@@ -9446,24 +10549,28 @@ class ParenthesizedExpression extends Expression { |
/** |
* Return the expression within the parentheses. |
+ * |
* @return the expression within the parentheses |
*/ |
Expression get expression => _expression; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
* Set the expression within the parentheses to the given expression. |
+ * |
* @param expression the expression within the parentheses |
*/ |
void set expression(Expression expression2) { |
@@ -9472,6 +10579,7 @@ class ParenthesizedExpression extends Expression { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param parenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token parenthesis) { |
@@ -9480,6 +10588,7 @@ class ParenthesizedExpression extends Expression { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param parenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token parenthesis) { |
@@ -9491,9 +10600,12 @@ class ParenthesizedExpression extends Expression { |
} |
/** |
* Instances of the class `PartDirective` represent a part directive. |
+ * |
* <pre> |
- * partDirective ::=[Annotation metadata] 'part' [StringLiteral partUri] ';' |
+ * partDirective ::= |
+ * [Annotation] 'part' [StringLiteral] ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class PartDirective extends UriBasedDirective { |
@@ -9510,6 +10622,7 @@ class PartDirective extends UriBasedDirective { |
/** |
* Initialize a newly created part directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param partToken the token representing the 'part' token |
@@ -9523,6 +10636,7 @@ class PartDirective extends UriBasedDirective { |
/** |
* Initialize a newly created part directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param partToken the token representing the 'part' token |
@@ -9536,12 +10650,14 @@ class PartDirective extends UriBasedDirective { |
/** |
* Return the token representing the 'part' token. |
+ * |
* @return the token representing the 'part' token |
*/ |
Token get partToken => _partToken; |
/** |
* Return the semicolon terminating the directive. |
+ * |
* @return the semicolon terminating the directive |
*/ |
Token get semicolon => _semicolon; |
@@ -9549,6 +10665,7 @@ class PartDirective extends UriBasedDirective { |
/** |
* Set the token representing the 'part' token to the given token. |
+ * |
* @param partToken the token representing the 'part' token |
*/ |
void set partToken(Token partToken2) { |
@@ -9557,6 +10674,7 @@ class PartDirective extends UriBasedDirective { |
/** |
* Set the semicolon terminating the directive to the given token. |
+ * |
* @param semicolon the semicolon terminating the directive |
*/ |
void set semicolon(Token semicolon2) { |
@@ -9566,9 +10684,12 @@ class PartDirective extends UriBasedDirective { |
} |
/** |
* Instances of the class `PartOfDirective` represent a part-of directive. |
+ * |
* <pre> |
- * partOfDirective ::=[Annotation metadata] 'part' 'of' [Identifier libraryName] ';' |
+ * partOfDirective ::= |
+ * [Annotation] 'part' 'of' [Identifier] ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class PartOfDirective extends Directive { |
@@ -9595,6 +10716,7 @@ class PartOfDirective extends Directive { |
/** |
* Initialize a newly created part-of directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param partToken the token representing the 'part' token |
@@ -9611,6 +10733,7 @@ class PartOfDirective extends Directive { |
/** |
* Initialize a newly created part-of directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param partToken the token representing the 'part' token |
@@ -9625,30 +10748,35 @@ class PartOfDirective extends Directive { |
/** |
* Return the name of the library that the containing compilation unit is part of. |
+ * |
* @return the name of the library that the containing compilation unit is part of |
*/ |
LibraryIdentifier get libraryName => _libraryName; |
/** |
* Return the token representing the 'of' token. |
+ * |
* @return the token representing the 'of' token |
*/ |
Token get ofToken => _ofToken; |
/** |
* Return the token representing the 'part' token. |
+ * |
* @return the token representing the 'part' token |
*/ |
Token get partToken => _partToken; |
/** |
* Return the semicolon terminating the directive. |
+ * |
* @return the semicolon terminating the directive |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the name of the library that the containing compilation unit is part of to the given name. |
+ * |
* @param libraryName the name of the library that the containing compilation unit is part of |
*/ |
void set libraryName(LibraryIdentifier libraryName2) { |
@@ -9657,6 +10785,7 @@ class PartOfDirective extends Directive { |
/** |
* Set the token representing the 'of' token to the given token. |
+ * |
* @param ofToken the token representing the 'of' token |
*/ |
void set ofToken(Token ofToken2) { |
@@ -9665,6 +10794,7 @@ class PartOfDirective extends Directive { |
/** |
* Set the token representing the 'part' token to the given token. |
+ * |
* @param partToken the token representing the 'part' token |
*/ |
void set partToken(Token partToken2) { |
@@ -9673,6 +10803,7 @@ class PartOfDirective extends Directive { |
/** |
* Set the semicolon terminating the directive to the given token. |
+ * |
* @param semicolon the semicolon terminating the directive |
*/ |
void set semicolon(Token semicolon2) { |
@@ -9686,8 +10817,12 @@ class PartOfDirective extends Directive { |
} |
/** |
* Instances of the class `PostfixExpression` represent a postfix unary expression. |
+ * |
* <pre> |
- * postfixExpression ::=[Expression operand] [Token operator]</pre> |
+ * postfixExpression ::= |
+ * [Expression] [Token] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class PostfixExpression extends Expression { |
@@ -9703,19 +10838,22 @@ class PostfixExpression extends Expression { |
Token _operator; |
/** |
- * The element associated with this the operator based on the propagated type of the operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * The element associated with this the operator based on the propagated type of the operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. |
*/ |
MethodElement _propagatedElement; |
/** |
- * The element associated with the operator based on the static type of the operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * The element associated with the operator based on the static type of the operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. |
*/ |
MethodElement _staticElement; |
/** |
* Initialize a newly created postfix expression. |
+ * |
* @param operand the expression computing the operand for the operator |
* @param operator the postfix operator being applied to the operand |
*/ |
@@ -9726,6 +10864,7 @@ class PostfixExpression extends Expression { |
/** |
* Initialize a newly created postfix expression. |
+ * |
* @param operand the expression computing the operand for the operator |
* @param operator the postfix operator being applied to the operand |
*/ |
@@ -9734,9 +10873,11 @@ class PostfixExpression extends Expression { |
Token get beginToken => _operand.beginToken; |
/** |
- * Return the element associated with the operator based on the propagated type of the operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * Return the element associated with the operator based on the propagated type of the operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. One example of the latter case is an operator that is |
* not defined for the type of the operand. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get element => _propagatedElement; |
@@ -9744,20 +10885,24 @@ class PostfixExpression extends Expression { |
/** |
* Return the expression computing the operand for the operator. |
+ * |
* @return the expression computing the operand for the operator |
*/ |
Expression get operand => _operand; |
/** |
* Return the postfix operator being applied to the operand. |
+ * |
* @return the postfix operator being applied to the operand |
*/ |
Token get operator => _operator; |
/** |
- * Return the element associated with the operator based on the static type of the operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * Return the element associated with the operator based on the static type of the operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. One example of the latter case is an operator that is |
* not defined for the type of the operand. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get staticElement => _staticElement; |
@@ -9765,6 +10910,7 @@ class PostfixExpression extends Expression { |
/** |
* Set the element associated with the operator based on the propagated type of the operand to the |
* given element. |
+ * |
* @param element the element to be associated with the operator |
*/ |
void set element(MethodElement element2) { |
@@ -9773,6 +10919,7 @@ class PostfixExpression extends Expression { |
/** |
* Set the expression computing the operand for the operator to the given expression. |
+ * |
* @param expression the expression computing the operand for the operator |
*/ |
void set operand(Expression expression) { |
@@ -9781,6 +10928,7 @@ class PostfixExpression extends Expression { |
/** |
* Set the postfix operator being applied to the operand to the given operator. |
+ * |
* @param operator the postfix operator being applied to the operand |
*/ |
void set operator(Token operator2) { |
@@ -9790,6 +10938,7 @@ class PostfixExpression extends Expression { |
/** |
* Set the element associated with the operator based on the static type of the operand to the |
* given element. |
+ * |
* @param element the element to be associated with the operator |
*/ |
void set staticElement(MethodElement element) { |
@@ -9805,8 +10954,9 @@ class PostfixExpression extends Expression { |
* which the value of the operand will be bound. Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getParameterElement]. |
+ * |
* @return the parameter element representing the parameter to which the value of the right |
- * operand will be bound |
+ * operand will be bound |
*/ |
ParameterElement get propagatedParameterElementForOperand { |
if (_propagatedElement == null) { |
@@ -9825,8 +10975,9 @@ class PostfixExpression extends Expression { |
* value of the operand will be bound. Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getStaticParameterElement]. |
+ * |
* @return the parameter element representing the parameter to which the value of the right |
- * operand will be bound |
+ * operand will be bound |
*/ |
ParameterElement get staticParameterElementForOperand { |
if (_staticElement == null) { |
@@ -9841,8 +10992,12 @@ class PostfixExpression extends Expression { |
} |
/** |
* Instances of the class `PrefixExpression` represent a prefix unary expression. |
+ * |
* <pre> |
- * prefixExpression ::=[Token operator] [Expression operand]</pre> |
+ * prefixExpression ::= |
+ * [Token] [Expression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class PrefixExpression extends Expression { |
@@ -9858,19 +11013,22 @@ class PrefixExpression extends Expression { |
Expression _operand; |
/** |
- * The element associated with the operator based on the static type of the operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * The element associated with the operator based on the static type of the operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. |
*/ |
MethodElement _staticElement; |
/** |
- * The element associated with the operator based on the propagated type of the operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * The element associated with the operator based on the propagated type of the operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. |
*/ |
MethodElement _propagatedElement; |
/** |
* Initialize a newly created prefix expression. |
+ * |
* @param operator the prefix operator being applied to the operand |
* @param operand the expression computing the operand for the operator |
*/ |
@@ -9881,6 +11039,7 @@ class PrefixExpression extends Expression { |
/** |
* Initialize a newly created prefix expression. |
+ * |
* @param operator the prefix operator being applied to the operand |
* @param operand the expression computing the operand for the operator |
*/ |
@@ -9889,9 +11048,11 @@ class PrefixExpression extends Expression { |
Token get beginToken => _operator; |
/** |
- * Return the element associated with the operator based on the propagated type of the operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * Return the element associated with the operator based on the propagated type of the operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. One example of the latter case is an operator that is |
* not defined for the type of the operand. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get element => _propagatedElement; |
@@ -9899,20 +11060,24 @@ class PrefixExpression extends Expression { |
/** |
* Return the expression computing the operand for the operator. |
+ * |
* @return the expression computing the operand for the operator |
*/ |
Expression get operand => _operand; |
/** |
* Return the prefix operator being applied to the operand. |
+ * |
* @return the prefix operator being applied to the operand |
*/ |
Token get operator => _operator; |
/** |
- * Return the element associated with the operator based on the static type of the operand, or`null` if the AST structure has not been resolved, if the operator is not user definable, |
+ * Return the element associated with the operator based on the static type of the operand, or |
+ * `null` if the AST structure has not been resolved, if the operator is not user definable, |
* or if the operator could not be resolved. One example of the latter case is an operator that is |
* not defined for the type of the operand. |
+ * |
* @return the element associated with the operator |
*/ |
MethodElement get staticElement => _staticElement; |
@@ -9920,6 +11085,7 @@ class PrefixExpression extends Expression { |
/** |
* Set the element associated with the operator based on the propagated type of the operand to the |
* given element. |
+ * |
* @param element the element to be associated with the operator |
*/ |
void set element(MethodElement element2) { |
@@ -9928,6 +11094,7 @@ class PrefixExpression extends Expression { |
/** |
* Set the expression computing the operand for the operator to the given expression. |
+ * |
* @param expression the expression computing the operand for the operator |
*/ |
void set operand(Expression expression) { |
@@ -9936,6 +11103,7 @@ class PrefixExpression extends Expression { |
/** |
* Set the prefix operator being applied to the operand to the given operator. |
+ * |
* @param operator the prefix operator being applied to the operand |
*/ |
void set operator(Token operator2) { |
@@ -9945,6 +11113,7 @@ class PrefixExpression extends Expression { |
/** |
* Set the element associated with the operator based on the static type of the operand to the |
* given element. |
+ * |
* @param element the static element to be associated with the operator |
*/ |
void set staticElement(MethodElement element) { |
@@ -9960,8 +11129,9 @@ class PrefixExpression extends Expression { |
* which the value of the operand will be bound. Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getParameterElement]. |
+ * |
* @return the parameter element representing the parameter to which the value of the right |
- * operand will be bound |
+ * operand will be bound |
*/ |
ParameterElement get propagatedParameterElementForOperand { |
if (_propagatedElement == null) { |
@@ -9980,8 +11150,9 @@ class PrefixExpression extends Expression { |
* value of the operand will be bound. Otherwise, return `null`. |
* |
* This method is only intended to be used by [Expression#getStaticParameterElement]. |
+ * |
* @return the parameter element representing the parameter to which the value of the right |
- * operand will be bound |
+ * operand will be bound |
*/ |
ParameterElement get staticParameterElementForOperand { |
if (_staticElement == null) { |
@@ -9998,8 +11169,12 @@ class PrefixExpression extends Expression { |
* Instances of the class `PrefixedIdentifier` represent either an identifier that is prefixed |
* or an access to an object property where the target of the property access is a simple |
* identifier. |
+ * |
* <pre> |
- * prefixedIdentifier ::=[SimpleIdentifier prefix] '.' [SimpleIdentifier identifier]</pre> |
+ * prefixedIdentifier ::= |
+ * [SimpleIdentifier] '.' [SimpleIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class PrefixedIdentifier extends Identifier { |
@@ -10021,6 +11196,7 @@ class PrefixedIdentifier extends Identifier { |
/** |
* Initialize a newly created prefixed identifier. |
+ * |
* @param prefix the identifier being prefixed |
* @param period the period used to separate the prefix from the identifier |
* @param identifier the prefix associated with the library in which the identifier is defined |
@@ -10033,6 +11209,7 @@ class PrefixedIdentifier extends Identifier { |
/** |
* Initialize a newly created prefixed identifier. |
+ * |
* @param prefix the identifier being prefixed |
* @param period the period used to separate the prefix from the identifier |
* @param identifier the prefix associated with the library in which the identifier is defined |
@@ -10050,6 +11227,7 @@ class PrefixedIdentifier extends Identifier { |
/** |
* Return the identifier being prefixed. |
+ * |
* @return the identifier being prefixed |
*/ |
SimpleIdentifier get identifier => _identifier; |
@@ -10057,12 +11235,14 @@ class PrefixedIdentifier extends Identifier { |
/** |
* Return the period used to separate the prefix from the identifier. |
+ * |
* @return the period used to separate the prefix from the identifier |
*/ |
Token get period => _period; |
/** |
* Return the prefix associated with the library in which the identifier is defined. |
+ * |
* @return the prefix associated with the library in which the identifier is defined |
*/ |
SimpleIdentifier get prefix => _prefix; |
@@ -10075,6 +11255,7 @@ class PrefixedIdentifier extends Identifier { |
/** |
* Set the identifier being prefixed to the given identifier. |
+ * |
* @param identifier the identifier being prefixed |
*/ |
void set identifier(SimpleIdentifier identifier2) { |
@@ -10083,6 +11264,7 @@ class PrefixedIdentifier extends Identifier { |
/** |
* Set the period used to separate the prefix from the identifier to the given token. |
+ * |
* @param period the period used to separate the prefix from the identifier |
*/ |
void set period(Token period2) { |
@@ -10092,6 +11274,7 @@ class PrefixedIdentifier extends Identifier { |
/** |
* Set the prefix associated with the library in which the identifier is defined to the given |
* identifier. |
+ * |
* @param identifier the prefix associated with the library in which the identifier is defined |
*/ |
void set prefix(SimpleIdentifier identifier) { |
@@ -10105,10 +11288,15 @@ class PrefixedIdentifier extends Identifier { |
/** |
* Instances of the class `PropertyAccess` represent the access of a property of an object. |
* |
- * Note, however, that accesses to properties of objects can also be represented as[PrefixedIdentifier prefixed identifier] nodes in cases where the target is also a simple |
+ * Note, however, that accesses to properties of objects can also be represented as |
+ * [PrefixedIdentifier] nodes in cases where the target is also a simple |
* identifier. |
+ * |
* <pre> |
- * propertyAccess ::=[Expression target] '.' [SimpleIdentifier propertyName]</pre> |
+ * propertyAccess ::= |
+ * [Expression] '.' [SimpleIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class PropertyAccess extends Expression { |
@@ -10130,6 +11318,7 @@ class PropertyAccess extends Expression { |
/** |
* Initialize a newly created property access expression. |
+ * |
* @param target the expression computing the object defining the property being accessed |
* @param operator the property access operator |
* @param propertyName the name of the property being accessed |
@@ -10142,6 +11331,7 @@ class PropertyAccess extends Expression { |
/** |
* Initialize a newly created property access expression. |
+ * |
* @param target the expression computing the object defining the property being accessed |
* @param operator the property access operator |
* @param propertyName the name of the property being accessed |
@@ -10158,12 +11348,14 @@ class PropertyAccess extends Expression { |
/** |
* Return the property access operator. |
+ * |
* @return the property access operator |
*/ |
Token get operator => _operator; |
/** |
* Return the name of the property being accessed. |
+ * |
* @return the name of the property being accessed |
*/ |
SimpleIdentifier get propertyName => _propertyName; |
@@ -10173,6 +11365,7 @@ class PropertyAccess extends Expression { |
* part of a cascade expression, then this is the same as [getTarget]. If this invocation |
* is part of a cascade expression, then the target stored with the cascade expression is |
* returned. |
+ * |
* @return the expression used to compute the receiver of the invocation |
* @see #getTarget() |
*/ |
@@ -10191,7 +11384,9 @@ class PropertyAccess extends Expression { |
} |
/** |
- * Return the expression computing the object defining the property being accessed, or`null` if this property access is part of a cascade expression. |
+ * Return the expression computing the object defining the property being accessed, or |
+ * `null` if this property access is part of a cascade expression. |
+ * |
* @return the expression computing the object defining the property being accessed |
* @see #getRealTarget() |
*/ |
@@ -10200,13 +11395,16 @@ class PropertyAccess extends Expression { |
/** |
* Return `true` if this expression is cascaded. If it is, then the target of this |
- * expression is not stored locally but is stored in the nearest ancestor that is a[CascadeExpression]. |
+ * expression is not stored locally but is stored in the nearest ancestor that is a |
+ * [CascadeExpression]. |
+ * |
* @return `true` if this expression is cascaded |
*/ |
bool get isCascaded => _operator != null && identical(_operator.type, TokenType.PERIOD_PERIOD); |
/** |
* Set the property access operator to the given token. |
+ * |
* @param operator the property access operator |
*/ |
void set operator(Token operator2) { |
@@ -10215,6 +11413,7 @@ class PropertyAccess extends Expression { |
/** |
* Set the name of the property being accessed to the given identifier. |
+ * |
* @param identifier the name of the property being accessed |
*/ |
void set propertyName(SimpleIdentifier identifier) { |
@@ -10224,6 +11423,7 @@ class PropertyAccess extends Expression { |
/** |
* Set the expression computing the object defining the property being accessed to the given |
* expression. |
+ * |
* @param expression the expression computing the object defining the property being accessed |
*/ |
void set target(Expression expression) { |
@@ -10237,10 +11437,12 @@ class PropertyAccess extends Expression { |
/** |
* Instances of the class `RedirectingConstructorInvocation` represent the invocation of a |
* another constructor in the same class from within a constructor's initialization list. |
+ * |
* <pre> |
* redirectingConstructorInvocation ::= |
- * 'this' ('.' identifier)? arguments |
+ * 'this' ('.' identifier)? arguments |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class RedirectingConstructorInvocation extends ConstructorInitializer { |
@@ -10251,7 +11453,8 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
Token _keyword; |
/** |
- * The token for the period before the name of the constructor that is being invoked, or`null` if the unnamed constructor is being invoked. |
+ * The token for the period before the name of the constructor that is being invoked, or |
+ * `null` if the unnamed constructor is being invoked. |
*/ |
Token _period; |
@@ -10267,12 +11470,14 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
ArgumentList _argumentList; |
/** |
- * The element associated with the constructor based on static type information, or `null`if the AST structure has not been resolved or if the constructor could not be resolved. |
+ * The element associated with the constructor based on static type information, or `null` |
+ * if the AST structure has not been resolved or if the constructor could not be resolved. |
*/ |
ConstructorElement _staticElement; |
/** |
- * The element associated with the constructor based on propagated type information, or`null` if the AST structure has not been resolved or if the constructor could not be |
+ * The element associated with the constructor based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or if the constructor could not be |
* resolved. |
*/ |
ConstructorElement _propagatedElement; |
@@ -10280,6 +11485,7 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Initialize a newly created redirecting invocation to invoke the constructor with the given name |
* with the given arguments. |
+ * |
* @param keyword the token for the 'this' keyword |
* @param period the token for the period before the name of the constructor that is being invoked |
* @param constructorName the name of the constructor that is being invoked |
@@ -10295,6 +11501,7 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Initialize a newly created redirecting invocation to invoke the constructor with the given name |
* with the given arguments. |
+ * |
* @param keyword the token for the 'this' keyword |
* @param period the token for the period before the name of the constructor that is being invoked |
* @param constructorName the name of the constructor that is being invoked |
@@ -10305,6 +11512,7 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Return the list of arguments to the constructor. |
+ * |
* @return the list of arguments to the constructor |
*/ |
ArgumentList get argumentList => _argumentList; |
@@ -10313,13 +11521,16 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Return the name of the constructor that is being invoked, or `null` if the unnamed |
* constructor is being invoked. |
+ * |
* @return the name of the constructor that is being invoked |
*/ |
SimpleIdentifier get constructorName => _constructorName; |
/** |
- * Return the element associated with the constructor based on propagated type information, or`null` if the AST structure has not been resolved or if the constructor could not be |
+ * Return the element associated with the constructor based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or if the constructor could not be |
* resolved. |
+ * |
* @return the element associated with the super constructor |
*/ |
ConstructorElement get element => _propagatedElement; |
@@ -10327,25 +11538,31 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Return the token for the 'this' keyword. |
+ * |
* @return the token for the 'this' keyword |
*/ |
Token get keyword => _keyword; |
/** |
- * Return the token for the period before the name of the constructor that is being invoked, or`null` if the unnamed constructor is being invoked. |
+ * Return the token for the period before the name of the constructor that is being invoked, or |
+ * `null` if the unnamed constructor is being invoked. |
+ * |
* @return the token for the period before the name of the constructor that is being invoked |
*/ |
Token get period => _period; |
/** |
- * Return the element associated with the constructor based on static type information, or`null` if the AST structure has not been resolved or if the constructor could not be |
+ * Return the element associated with the constructor based on static type information, or |
+ * `null` if the AST structure has not been resolved or if the constructor could not be |
* resolved. |
+ * |
* @return the element associated with the constructor |
*/ |
ConstructorElement get staticElement => _staticElement; |
/** |
* Set the list of arguments to the constructor to the given list. |
+ * |
* @param argumentList the list of arguments to the constructor |
*/ |
void set argumentList(ArgumentList argumentList2) { |
@@ -10354,6 +11571,7 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the name of the constructor that is being invoked to the given identifier. |
+ * |
* @param identifier the name of the constructor that is being invoked |
*/ |
void set constructorName(SimpleIdentifier identifier) { |
@@ -10363,6 +11581,7 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the element associated with the constructor based on propagated type information to the |
* given element. |
+ * |
* @param element the element to be associated with the constructor |
*/ |
void set element(ConstructorElement element2) { |
@@ -10371,6 +11590,7 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the token for the 'this' keyword to the given token. |
+ * |
* @param keyword the token for the 'this' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -10380,6 +11600,7 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the token for the period before the name of the constructor that is being invoked to the |
* given token. |
+ * |
* @param period the token for the period before the name of the constructor that is being invoked |
*/ |
void set period(Token period2) { |
@@ -10389,6 +11610,7 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the element associated with the constructor based on static type information to the given |
* element. |
+ * |
* @param element the element to be associated with the constructor |
*/ |
void set staticElement(ConstructorElement element) { |
@@ -10401,10 +11623,12 @@ class RedirectingConstructorInvocation extends ConstructorInitializer { |
} |
/** |
* Instances of the class `RethrowExpression` represent a rethrow expression. |
+ * |
* <pre> |
* rethrowExpression ::= |
- * 'rethrow' |
+ * 'rethrow' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class RethrowExpression extends Expression { |
@@ -10416,6 +11640,7 @@ class RethrowExpression extends Expression { |
/** |
* Initialize a newly created rethrow expression. |
+ * |
* @param keyword the token representing the 'rethrow' keyword |
*/ |
RethrowExpression.full(Token keyword) { |
@@ -10424,6 +11649,7 @@ class RethrowExpression extends Expression { |
/** |
* Initialize a newly created rethrow expression. |
+ * |
* @param keyword the token representing the 'rethrow' keyword |
*/ |
RethrowExpression({Token keyword}) : this.full(keyword); |
@@ -10433,12 +11659,14 @@ class RethrowExpression extends Expression { |
/** |
* Return the token representing the 'rethrow' keyword. |
+ * |
* @return the token representing the 'rethrow' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Set the token representing the 'rethrow' keyword to the given token. |
+ * |
* @param keyword the token representing the 'rethrow' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -10449,10 +11677,12 @@ class RethrowExpression extends Expression { |
} |
/** |
* Instances of the class `ReturnStatement` represent a return statement. |
+ * |
* <pre> |
* returnStatement ::= |
- * 'return' [Expression expression]? ';' |
+ * 'return' [Expression]? ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ReturnStatement extends Statement { |
@@ -10475,6 +11705,7 @@ class ReturnStatement extends Statement { |
/** |
* Initialize a newly created return statement. |
+ * |
* @param keyword the token representing the 'return' keyword |
* @param expression the expression computing the value to be returned |
* @param semicolon the semicolon terminating the statement |
@@ -10487,6 +11718,7 @@ class ReturnStatement extends Statement { |
/** |
* Initialize a newly created return statement. |
+ * |
* @param keyword the token representing the 'return' keyword |
* @param expression the expression computing the value to be returned |
* @param semicolon the semicolon terminating the statement |
@@ -10499,24 +11731,28 @@ class ReturnStatement extends Statement { |
/** |
* Return the expression computing the value to be returned, or `null` if no explicit value |
* was provided. |
+ * |
* @return the expression computing the value to be returned |
*/ |
Expression get expression => _expression; |
/** |
* Return the token representing the 'return' keyword. |
+ * |
* @return the token representing the 'return' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the expression computing the value to be returned to the given expression. |
+ * |
* @param expression the expression computing the value to be returned |
*/ |
void set expression(Expression expression2) { |
@@ -10525,6 +11761,7 @@ class ReturnStatement extends Statement { |
/** |
* Set the token representing the 'return' keyword to the given token. |
+ * |
* @param keyword the token representing the 'return' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -10533,6 +11770,7 @@ class ReturnStatement extends Statement { |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -10545,10 +11783,12 @@ class ReturnStatement extends Statement { |
/** |
* Instances of the class `ScriptTag` represent the script tag that can optionally occur at |
* the beginning of a compilation unit. |
+ * |
* <pre> |
* scriptTag ::= |
- * '#!' (~NEWLINE)* NEWLINE |
+ * '#!' (~NEWLINE)* NEWLINE |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ScriptTag extends ASTNode { |
@@ -10560,6 +11800,7 @@ class ScriptTag extends ASTNode { |
/** |
* Initialize a newly created script tag. |
+ * |
* @param scriptTag the token representing this script tag |
*/ |
ScriptTag.full(Token scriptTag) { |
@@ -10568,6 +11809,7 @@ class ScriptTag extends ASTNode { |
/** |
* Initialize a newly created script tag. |
+ * |
* @param scriptTag the token representing this script tag |
*/ |
ScriptTag({Token scriptTag}) : this.full(scriptTag); |
@@ -10577,12 +11819,14 @@ class ScriptTag extends ASTNode { |
/** |
* Return the token representing this script tag. |
+ * |
* @return the token representing this script tag |
*/ |
Token get scriptTag => _scriptTag; |
/** |
* Set the token representing this script tag to the given script tag. |
+ * |
* @param scriptTag the token representing this script tag |
*/ |
void set scriptTag(Token scriptTag2) { |
@@ -10594,10 +11838,12 @@ class ScriptTag extends ASTNode { |
/** |
* Instances of the class `ShowCombinator` represent a combinator that restricts the names |
* being imported to those in a given list. |
+ * |
* <pre> |
* showCombinator ::= |
- * 'show' [SimpleIdentifier identifier] (',' [SimpleIdentifier identifier]) |
+ * 'show' [SimpleIdentifier] (',' [SimpleIdentifier])* |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ShowCombinator extends Combinator { |
@@ -10609,6 +11855,7 @@ class ShowCombinator extends Combinator { |
/** |
* Initialize a newly created import show combinator. |
+ * |
* @param keyword the comma introducing the combinator |
* @param shownNames the list of names from the library that are made visible by this combinator |
*/ |
@@ -10619,6 +11866,7 @@ class ShowCombinator extends Combinator { |
/** |
* Initialize a newly created import show combinator. |
+ * |
* @param keyword the comma introducing the combinator |
* @param shownNames the list of names from the library that are made visible by this combinator |
*/ |
@@ -10628,6 +11876,7 @@ class ShowCombinator extends Combinator { |
/** |
* Return the list of names from the library that are made visible by this combinator. |
+ * |
* @return the list of names from the library that are made visible by this combinator |
*/ |
NodeList<SimpleIdentifier> get shownNames => _shownNames; |
@@ -10637,9 +11886,12 @@ class ShowCombinator extends Combinator { |
} |
/** |
* Instances of the class `SimpleFormalParameter` represent a simple formal parameter. |
+ * |
* <pre> |
* simpleFormalParameter ::= |
- * ('final' [TypeName type] | 'var' | [TypeName type])? [SimpleIdentifier identifier]</pre> |
+ * ('final' [TypeName] | 'var' | [TypeName])? [SimpleIdentifier] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class SimpleFormalParameter extends NormalFormalParameter { |
@@ -10658,6 +11910,7 @@ class SimpleFormalParameter extends NormalFormalParameter { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
@@ -10671,6 +11924,7 @@ class SimpleFormalParameter extends NormalFormalParameter { |
/** |
* Initialize a newly created formal parameter. |
+ * |
* @param comment the documentation comment associated with this parameter |
* @param metadata the annotations associated with this parameter |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
@@ -10691,6 +11945,7 @@ class SimpleFormalParameter extends NormalFormalParameter { |
/** |
* Return the token representing either the 'final', 'const' or 'var' keyword. |
+ * |
* @return the token representing either the 'final', 'const' or 'var' keyword |
*/ |
Token get keyword => _keyword; |
@@ -10698,6 +11953,7 @@ class SimpleFormalParameter extends NormalFormalParameter { |
/** |
* Return the name of the declared type of the parameter, or `null` if the parameter does |
* not have a declared type. |
+ * |
* @return the name of the declared type of the parameter |
*/ |
TypeName get type => _type; |
@@ -10706,6 +11962,7 @@ class SimpleFormalParameter extends NormalFormalParameter { |
/** |
* Set the token representing either the 'final', 'const' or 'var' keyword to the given token. |
+ * |
* @param keyword the token representing either the 'final', 'const' or 'var' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -10714,6 +11971,7 @@ class SimpleFormalParameter extends NormalFormalParameter { |
/** |
* Set the name of the declared type of the parameter to the given type name. |
+ * |
* @param typeName the name of the declared type of the parameter |
*/ |
void set type(TypeName typeName) { |
@@ -10727,12 +11985,16 @@ class SimpleFormalParameter extends NormalFormalParameter { |
} |
/** |
* Instances of the class `SimpleIdentifier` represent a simple identifier. |
+ * |
* <pre> |
* simpleIdentifier ::= |
- * initialCharacter internalCharacter |
+ * initialCharacter internalCharacter* |
+ * |
* initialCharacter ::= '_' | '$' | letter |
+ * |
* internalCharacter ::= '_' | '$' | letter | digit |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class SimpleIdentifier extends Identifier { |
@@ -10743,18 +12005,21 @@ class SimpleIdentifier extends Identifier { |
Token _token; |
/** |
- * The element associated with this identifier based on static type information, or `null`if the AST structure has not been resolved or if this identifier could not be resolved. |
+ * The element associated with this identifier based on static type information, or `null` |
+ * if the AST structure has not been resolved or if this identifier could not be resolved. |
*/ |
Element _staticElement; |
/** |
- * The element associated with this identifier based on propagated type information, or`null` if the AST structure has not been resolved or if this identifier could not be |
+ * The element associated with this identifier based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or if this identifier could not be |
* resolved. |
*/ |
Element _propagatedElement; |
/** |
* Initialize a newly created identifier. |
+ * |
* @param token the token representing the identifier |
*/ |
SimpleIdentifier.full(Token token) { |
@@ -10763,6 +12028,7 @@ class SimpleIdentifier extends Identifier { |
/** |
* Initialize a newly created identifier. |
+ * |
* @param token the token representing the identifier |
*/ |
SimpleIdentifier({Token token}) : this.full(token); |
@@ -10775,12 +12041,14 @@ class SimpleIdentifier extends Identifier { |
/** |
* Return the token representing the identifier. |
+ * |
* @return the token representing the identifier |
*/ |
Token get token => _token; |
/** |
* Return `true` if this identifier is the name being declared in a declaration. |
+ * |
* @return `true` if this identifier is the name being declared in a declaration |
*/ |
bool inDeclarationContext() { |
@@ -10816,7 +12084,9 @@ class SimpleIdentifier extends Identifier { |
* Return `true` if this expression is computing a right-hand value. |
* |
* Note that [inGetterContext] and [inSetterContext] are not opposites, nor are |
- * they mutually exclusive. In other words, it is possible for both methods to return `true`when invoked on the same node. |
+ * they mutually exclusive. In other words, it is possible for both methods to return `true` |
+ * when invoked on the same node. |
+ * |
* @return `true` if this expression is in a context where a getter will be invoked |
*/ |
bool inGetterContext() { |
@@ -10853,7 +12123,9 @@ class SimpleIdentifier extends Identifier { |
* Return `true` if this expression is computing a left-hand value. |
* |
* Note that [inGetterContext] and [inSetterContext] are not opposites, nor are |
- * they mutually exclusive. In other words, it is possible for both methods to return `true`when invoked on the same node. |
+ * they mutually exclusive. In other words, it is possible for both methods to return `true` |
+ * when invoked on the same node. |
+ * |
* @return `true` if this expression is in a context where a setter will be invoked |
*/ |
bool inSetterContext() { |
@@ -10888,6 +12160,7 @@ class SimpleIdentifier extends Identifier { |
/** |
* Set the element associated with this identifier based on propagated type information to the |
* given element. |
+ * |
* @param element the element to be associated with this identifier |
*/ |
void set element(Element element2) { |
@@ -10897,6 +12170,7 @@ class SimpleIdentifier extends Identifier { |
/** |
* Set the element associated with this identifier based on static type information to the given |
* element. |
+ * |
* @param element the element to be associated with this identifier |
*/ |
void set staticElement(Element element) { |
@@ -10905,6 +12179,7 @@ class SimpleIdentifier extends Identifier { |
/** |
* Set the token representing the identifier to the given token. |
+ * |
* @param token the token representing the literal |
*/ |
void set token(Token token2) { |
@@ -10916,22 +12191,28 @@ class SimpleIdentifier extends Identifier { |
/** |
* Instances of the class `SimpleStringLiteral` represent a string literal expression that |
* does not contain any interpolations. |
+ * |
* <pre> |
* simpleStringLiteral ::= |
- * rawStringLiteral |
- * | basicStringLiteral |
+ * rawStringLiteral |
+ * | basicStringLiteral |
+ * |
* rawStringLiteral ::= |
- * '@' basicStringLiteral |
+ * '@' basicStringLiteral |
+ * |
* simpleStringLiteral ::= |
- * multiLineStringLiteral |
- * | singleLineStringLiteral |
+ * multiLineStringLiteral |
+ * | singleLineStringLiteral |
+ * |
* multiLineStringLiteral ::= |
- * "'''" characters "'''" |
- * | '"""' characters '"""' |
+ * "'''" characters "'''" |
+ * | '"""' characters '"""' |
+ * |
* singleLineStringLiteral ::= |
- * "'" characters "'" |
- * '"' characters '"' |
+ * "'" characters "'" |
+ * '"' characters '"' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class SimpleStringLiteral extends StringLiteral { |
@@ -10948,6 +12229,7 @@ class SimpleStringLiteral extends StringLiteral { |
/** |
* Initialize a newly created simple string literal. |
+ * |
* @param literal the token representing the literal |
* @param value the value of the literal |
*/ |
@@ -10958,6 +12240,7 @@ class SimpleStringLiteral extends StringLiteral { |
/** |
* Initialize a newly created simple string literal. |
+ * |
* @param literal the token representing the literal |
* @param value the value of the literal |
*/ |
@@ -10968,18 +12251,21 @@ class SimpleStringLiteral extends StringLiteral { |
/** |
* Return the token representing the literal. |
+ * |
* @return the token representing the literal |
*/ |
Token get literal => _literal; |
/** |
* Return the value of the literal. |
+ * |
* @return the value of the literal |
*/ |
String get value => _value; |
/** |
* Return `true` if this string literal is a multi-line string. |
+ * |
* @return `true` if this string literal is a multi-line string |
*/ |
bool get isMultiline { |
@@ -10991,6 +12277,7 @@ class SimpleStringLiteral extends StringLiteral { |
/** |
* Return `true` if this string literal is a raw string. |
+ * |
* @return `true` if this string literal is a raw string |
*/ |
bool get isRaw => _value.codeUnitAt(0) == 0x40; |
@@ -10998,6 +12285,7 @@ class SimpleStringLiteral extends StringLiteral { |
/** |
* Set the token representing the literal to the given token. |
+ * |
* @param literal the token representing the literal |
*/ |
void set literal(Token literal2) { |
@@ -11006,6 +12294,7 @@ class SimpleStringLiteral extends StringLiteral { |
/** |
* Set the value of the literal to the given string. |
+ * |
* @param string the value of the literal |
*/ |
void set value(String string) { |
@@ -11020,19 +12309,38 @@ class SimpleStringLiteral extends StringLiteral { |
/** |
* Instances of the class `Statement` defines the behavior common to nodes that represent a |
* statement. |
+ * |
* <pre> |
- * statement ::=[Block block]| [VariableDeclarationStatement initializedVariableDeclaration ';']| [ForStatement forStatement]| [ForEachStatement forEachStatement]| [WhileStatement whileStatement]| [DoStatement doStatement]| [SwitchStatement switchStatement]| [IfStatement ifStatement]| [TryStatement tryStatement]| [BreakStatement breakStatement]| [ContinueStatement continueStatement]| [ReturnStatement returnStatement]| [ExpressionStatement expressionStatement]| [FunctionDeclarationStatement functionSignature functionBody]</pre> |
+ * statement ::= |
+ * [Block] |
+ * | [VariableDeclarationStatement] |
+ * | [ForStatement] |
+ * | [ForEachStatement] |
+ * | [WhileStatement] |
+ * | [DoStatement] |
+ * | [SwitchStatement] |
+ * | [IfStatement] |
+ * | [TryStatement] |
+ * | [BreakStatement] |
+ * | [ContinueStatement] |
+ * | [ReturnStatement] |
+ * | [ExpressionStatement] |
+ * | [FunctionDeclarationStatement] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class Statement extends ASTNode { |
} |
/** |
* Instances of the class `StringInterpolation` represent a string interpolation literal. |
+ * |
* <pre> |
* stringInterpolation ::= |
- * ''' [InterpolationElement interpolationElement]* ''' |
- * | '"' [InterpolationElement interpolationElement]* '"' |
+ * ''' [InterpolationElement]* ''' |
+ * | '"' [InterpolationElement]* '"' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class StringInterpolation extends StringLiteral { |
@@ -11044,6 +12352,7 @@ class StringInterpolation extends StringLiteral { |
/** |
* Initialize a newly created string interpolation expression. |
+ * |
* @param elements the elements that will be composed to produce the resulting string |
*/ |
StringInterpolation.full(List<InterpolationElement> elements) { |
@@ -11053,6 +12362,7 @@ class StringInterpolation extends StringLiteral { |
/** |
* Initialize a newly created string interpolation expression. |
+ * |
* @param elements the elements that will be composed to produce the resulting string |
*/ |
StringInterpolation({List<InterpolationElement> elements}) : this.full(elements); |
@@ -11061,6 +12371,7 @@ class StringInterpolation extends StringLiteral { |
/** |
* Return the elements that will be composed to produce the resulting string. |
+ * |
* @return the elements that will be composed to produce the resulting string |
*/ |
NodeList<InterpolationElement> get elements => _elements; |
@@ -11074,8 +12385,14 @@ class StringInterpolation extends StringLiteral { |
} |
/** |
* Instances of the class `StringLiteral` represent a string literal expression. |
+ * |
* <pre> |
- * stringLiteral ::=[SimpleStringLiteral simpleStringLiteral]| [AdjacentStrings adjacentStrings]| [StringInterpolation stringInterpolation]</pre> |
+ * stringLiteral ::= |
+ * [SimpleStringLiteral] |
+ * | [AdjacentStrings] |
+ * | [StringInterpolation] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class StringLiteral extends Literal { |
@@ -11083,6 +12400,7 @@ abstract class StringLiteral extends Literal { |
/** |
* Return the value of the string literal, or `null` if the string is not a constant string |
* without any string interpolation. |
+ * |
* @return the value of the string literal |
*/ |
String get stringValue { |
@@ -11097,18 +12415,22 @@ abstract class StringLiteral extends Literal { |
/** |
* Append the value of the given string literal to the given string builder. |
+ * |
* @param builder the builder to which the string's value is to be appended |
* @throws IllegalArgumentException if the string is not a constant string without any string |
- * interpolation |
+ * interpolation |
*/ |
void appendStringValue(JavaStringBuilder builder); |
} |
/** |
* Instances of the class `SuperConstructorInvocation` represent the invocation of a |
* superclass' constructor from within a constructor's initialization list. |
+ * |
* <pre> |
* superInvocation ::= |
- * 'super' ('.' [SimpleIdentifier name])? [ArgumentList argumentList]</pre> |
+ * 'super' ('.' [SimpleIdentifier])? [ArgumentList] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class SuperConstructorInvocation extends ConstructorInitializer { |
@@ -11119,7 +12441,8 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
Token _keyword; |
/** |
- * The token for the period before the name of the constructor that is being invoked, or`null` if the unnamed constructor is being invoked. |
+ * The token for the period before the name of the constructor that is being invoked, or |
+ * `null` if the unnamed constructor is being invoked. |
*/ |
Token _period; |
@@ -11135,7 +12458,8 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
ArgumentList _argumentList; |
/** |
- * The element associated with the constructor based on static type information, or `null`if the AST structure has not been resolved or if the constructor could not be resolved. |
+ * The element associated with the constructor based on static type information, or `null` |
+ * if the AST structure has not been resolved or if the constructor could not be resolved. |
*/ |
ConstructorElement _staticElement; |
@@ -11148,6 +12472,7 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Initialize a newly created super invocation to invoke the inherited constructor with the given |
* name with the given arguments. |
+ * |
* @param keyword the token for the 'super' keyword |
* @param period the token for the period before the name of the constructor that is being invoked |
* @param constructorName the name of the constructor that is being invoked |
@@ -11163,6 +12488,7 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Initialize a newly created super invocation to invoke the inherited constructor with the given |
* name with the given arguments. |
+ * |
* @param keyword the token for the 'super' keyword |
* @param period the token for the period before the name of the constructor that is being invoked |
* @param constructorName the name of the constructor that is being invoked |
@@ -11173,6 +12499,7 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Return the list of arguments to the constructor. |
+ * |
* @return the list of arguments to the constructor |
*/ |
ArgumentList get argumentList => _argumentList; |
@@ -11181,13 +12508,16 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Return the name of the constructor that is being invoked, or `null` if the unnamed |
* constructor is being invoked. |
+ * |
* @return the name of the constructor that is being invoked |
*/ |
SimpleIdentifier get constructorName => _constructorName; |
/** |
- * Return the element associated with the constructor based on propagated type information, or`null` if the AST structure has not been resolved or if the constructor could not be |
+ * Return the element associated with the constructor based on propagated type information, or |
+ * `null` if the AST structure has not been resolved or if the constructor could not be |
* resolved. |
+ * |
* @return the element associated with the super constructor |
*/ |
ConstructorElement get element => _propagatedElement; |
@@ -11195,25 +12525,31 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Return the token for the 'super' keyword. |
+ * |
* @return the token for the 'super' keyword |
*/ |
Token get keyword => _keyword; |
/** |
- * Return the token for the period before the name of the constructor that is being invoked, or`null` if the unnamed constructor is being invoked. |
+ * Return the token for the period before the name of the constructor that is being invoked, or |
+ * `null` if the unnamed constructor is being invoked. |
+ * |
* @return the token for the period before the name of the constructor that is being invoked |
*/ |
Token get period => _period; |
/** |
- * Return the element associated with the constructor based on static type information, or`null` if the AST structure has not been resolved or if the constructor could not be |
+ * Return the element associated with the constructor based on static type information, or |
+ * `null` if the AST structure has not been resolved or if the constructor could not be |
* resolved. |
+ * |
* @return the element associated with the constructor |
*/ |
ConstructorElement get staticElement => _staticElement; |
/** |
* Set the list of arguments to the constructor to the given list. |
+ * |
* @param argumentList the list of arguments to the constructor |
*/ |
void set argumentList(ArgumentList argumentList2) { |
@@ -11222,6 +12558,7 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the name of the constructor that is being invoked to the given identifier. |
+ * |
* @param identifier the name of the constructor that is being invoked |
*/ |
void set constructorName(SimpleIdentifier identifier) { |
@@ -11231,6 +12568,7 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the element associated with the constructor based on propagated type information to the |
* given element. |
+ * |
* @param element the element to be associated with the constructor |
*/ |
void set element(ConstructorElement element2) { |
@@ -11239,6 +12577,7 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the token for the 'super' keyword to the given token. |
+ * |
* @param keyword the token for the 'super' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -11248,6 +12587,7 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the token for the period before the name of the constructor that is being invoked to the |
* given token. |
+ * |
* @param period the token for the period before the name of the constructor that is being invoked |
*/ |
void set period(Token period2) { |
@@ -11257,6 +12597,7 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
/** |
* Set the element associated with the constructor based on static type information to the given |
* element. |
+ * |
* @param element the element to be associated with the constructor |
*/ |
void set staticElement(ConstructorElement element) { |
@@ -11269,10 +12610,12 @@ class SuperConstructorInvocation extends ConstructorInitializer { |
} |
/** |
* Instances of the class `SuperExpression` represent a super expression. |
+ * |
* <pre> |
* superExpression ::= |
- * 'super' |
+ * 'super' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class SuperExpression extends Expression { |
@@ -11284,6 +12627,7 @@ class SuperExpression extends Expression { |
/** |
* Initialize a newly created super expression. |
+ * |
* @param keyword the token representing the keyword |
*/ |
SuperExpression.full(Token keyword) { |
@@ -11292,6 +12636,7 @@ class SuperExpression extends Expression { |
/** |
* Initialize a newly created super expression. |
+ * |
* @param keyword the token representing the keyword |
*/ |
SuperExpression({Token keyword}) : this.full(keyword); |
@@ -11301,12 +12646,14 @@ class SuperExpression extends Expression { |
/** |
* Return the token representing the keyword. |
+ * |
* @return the token representing the keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Set the token representing the keyword to the given token. |
+ * |
* @param keyword the token representing the keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -11317,8 +12664,12 @@ class SuperExpression extends Expression { |
} |
/** |
* Instances of the class `SwitchCase` represent the case in a switch statement. |
+ * |
* <pre> |
- * switchCase ::=[SimpleIdentifier label]* 'case' [Expression expression] ':' [Statement statement]</pre> |
+ * switchCase ::= |
+ * [SimpleIdentifier]* 'case' [Expression] ':' [Statement]* |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class SwitchCase extends SwitchMember { |
@@ -11330,6 +12681,7 @@ class SwitchCase extends SwitchMember { |
/** |
* Initialize a newly created switch case. |
+ * |
* @param labels the labels associated with the switch member |
* @param keyword the token representing the 'case' or 'default' keyword |
* @param expression the expression controlling whether the statements will be executed |
@@ -11342,6 +12694,7 @@ class SwitchCase extends SwitchMember { |
/** |
* Initialize a newly created switch case. |
+ * |
* @param labels the labels associated with the switch member |
* @param keyword the token representing the 'case' or 'default' keyword |
* @param expression the expression controlling whether the statements will be executed |
@@ -11353,12 +12706,14 @@ class SwitchCase extends SwitchMember { |
/** |
* Return the expression controlling whether the statements will be executed. |
+ * |
* @return the expression controlling whether the statements will be executed |
*/ |
Expression get expression => _expression; |
/** |
* Set the expression controlling whether the statements will be executed to the given expression. |
+ * |
* @param expression the expression controlling whether the statements will be executed |
*/ |
void set expression(Expression expression2) { |
@@ -11372,14 +12727,19 @@ class SwitchCase extends SwitchMember { |
} |
/** |
* Instances of the class `SwitchDefault` represent the default case in a switch statement. |
+ * |
* <pre> |
- * switchDefault ::=[SimpleIdentifier label]* 'default' ':' [Statement statement]</pre> |
+ * switchDefault ::= |
+ * [SimpleIdentifier]* 'default' ':' [Statement]* |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class SwitchDefault extends SwitchMember { |
/** |
* Initialize a newly created switch default. |
+ * |
* @param labels the labels associated with the switch member |
* @param keyword the token representing the 'case' or 'default' keyword |
* @param colon the colon separating the keyword or the expression from the statements |
@@ -11390,6 +12750,7 @@ class SwitchDefault extends SwitchMember { |
/** |
* Initialize a newly created switch default. |
+ * |
* @param labels the labels associated with the switch member |
* @param keyword the token representing the 'case' or 'default' keyword |
* @param colon the colon separating the keyword or the expression from the statements |
@@ -11405,11 +12766,13 @@ class SwitchDefault extends SwitchMember { |
/** |
* The abstract class `SwitchMember` defines the behavior common to objects representing |
* elements within a switch statement. |
+ * |
* <pre> |
* switchMember ::= |
- * switchCase |
- * | switchDefault |
+ * switchCase |
+ * | switchDefault |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class SwitchMember extends ASTNode { |
@@ -11436,6 +12799,7 @@ abstract class SwitchMember extends ASTNode { |
/** |
* Initialize a newly created switch member. |
+ * |
* @param labels the labels associated with the switch member |
* @param keyword the token representing the 'case' or 'default' keyword |
* @param colon the colon separating the keyword or the expression from the statements |
@@ -11452,6 +12816,7 @@ abstract class SwitchMember extends ASTNode { |
/** |
* Initialize a newly created switch member. |
+ * |
* @param labels the labels associated with the switch member |
* @param keyword the token representing the 'case' or 'default' keyword |
* @param colon the colon separating the keyword or the expression from the statements |
@@ -11467,6 +12832,7 @@ abstract class SwitchMember extends ASTNode { |
/** |
* Return the colon separating the keyword or the expression from the statements. |
+ * |
* @return the colon separating the keyword or the expression from the statements |
*/ |
Token get colon => _colon; |
@@ -11479,24 +12845,28 @@ abstract class SwitchMember extends ASTNode { |
/** |
* Return the token representing the 'case' or 'default' keyword. |
+ * |
* @return the token representing the 'case' or 'default' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the labels associated with the switch member. |
+ * |
* @return the labels associated with the switch member |
*/ |
NodeList<Label> get labels => _labels; |
/** |
* Return the statements that will be executed if this switch member is selected. |
+ * |
* @return the statements that will be executed if this switch member is selected |
*/ |
NodeList<Statement> get statements => _statements; |
/** |
* Set the colon separating the keyword or the expression from the statements to the given token. |
+ * |
* @param colon the colon separating the keyword or the expression from the statements |
*/ |
void set colon(Token colon2) { |
@@ -11505,6 +12875,7 @@ abstract class SwitchMember extends ASTNode { |
/** |
* Set the token representing the 'case' or 'default' keyword to the given token. |
+ * |
* @param keyword the token representing the 'case' or 'default' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -11513,10 +12884,12 @@ abstract class SwitchMember extends ASTNode { |
} |
/** |
* Instances of the class `SwitchStatement` represent a switch statement. |
+ * |
* <pre> |
* switchStatement ::= |
- * 'switch' '(' [Expression expression] ')' '{' [SwitchCase switchCase]* [SwitchDefault defaultCase]? '}' |
+ * 'switch' '(' [Expression] ')' '{' [SwitchCase]* [SwitchDefault]? '}' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class SwitchStatement extends Statement { |
@@ -11558,6 +12931,7 @@ class SwitchStatement extends Statement { |
/** |
* Initialize a newly created switch statement. |
+ * |
* @param keyword the token representing the 'switch' keyword |
* @param leftParenthesis the left parenthesis |
* @param expression the expression used to determine which of the switch members will be selected |
@@ -11579,6 +12953,7 @@ class SwitchStatement extends Statement { |
/** |
* Initialize a newly created switch statement. |
+ * |
* @param keyword the token representing the 'switch' keyword |
* @param leftParenthesis the left parenthesis |
* @param expression the expression used to determine which of the switch members will be selected |
@@ -11594,42 +12969,49 @@ class SwitchStatement extends Statement { |
/** |
* Return the expression used to determine which of the switch members will be selected. |
+ * |
* @return the expression used to determine which of the switch members will be selected |
*/ |
Expression get expression => _expression; |
/** |
* Return the token representing the 'switch' keyword. |
+ * |
* @return the token representing the 'switch' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the left curly bracket. |
+ * |
* @return the left curly bracket |
*/ |
Token get leftBracket => _leftBracket; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the switch members that can be selected by the expression. |
+ * |
* @return the switch members that can be selected by the expression |
*/ |
NodeList<SwitchMember> get members => _members; |
/** |
* Return the right curly bracket. |
+ * |
* @return the right curly bracket |
*/ |
Token get rightBracket => _rightBracket; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
@@ -11637,6 +13019,7 @@ class SwitchStatement extends Statement { |
/** |
* Set the expression used to determine which of the switch members will be selected to the given |
* expression. |
+ * |
* @param expression the expression used to determine which of the switch members will be selected |
*/ |
void set expression(Expression expression2) { |
@@ -11645,6 +13028,7 @@ class SwitchStatement extends Statement { |
/** |
* Set the token representing the 'switch' keyword to the given token. |
+ * |
* @param keyword the token representing the 'switch' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -11653,6 +13037,7 @@ class SwitchStatement extends Statement { |
/** |
* Set the left curly bracket to the given token. |
+ * |
* @param leftBracket the left curly bracket |
*/ |
void set leftBracket(Token leftBracket2) { |
@@ -11661,6 +13046,7 @@ class SwitchStatement extends Statement { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param leftParenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token leftParenthesis2) { |
@@ -11669,6 +13055,7 @@ class SwitchStatement extends Statement { |
/** |
* Set the right curly bracket to the given token. |
+ * |
* @param rightBracket the right curly bracket |
*/ |
void set rightBracket(Token rightBracket2) { |
@@ -11677,6 +13064,7 @@ class SwitchStatement extends Statement { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param rightParenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token rightParenthesis2) { |
@@ -11689,10 +13077,12 @@ class SwitchStatement extends Statement { |
} |
/** |
* Instances of the class `ThisExpression` represent a this expression. |
+ * |
* <pre> |
* thisExpression ::= |
- * 'this' |
+ * 'this' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ThisExpression extends Expression { |
@@ -11704,6 +13094,7 @@ class ThisExpression extends Expression { |
/** |
* Initialize a newly created this expression. |
+ * |
* @param keyword the token representing the keyword |
*/ |
ThisExpression.full(Token keyword) { |
@@ -11712,6 +13103,7 @@ class ThisExpression extends Expression { |
/** |
* Initialize a newly created this expression. |
+ * |
* @param keyword the token representing the keyword |
*/ |
ThisExpression({Token keyword}) : this.full(keyword); |
@@ -11721,12 +13113,14 @@ class ThisExpression extends Expression { |
/** |
* Return the token representing the keyword. |
+ * |
* @return the token representing the keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Set the token representing the keyword to the given token. |
+ * |
* @param keyword the token representing the keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -11737,9 +13131,12 @@ class ThisExpression extends Expression { |
} |
/** |
* Instances of the class `ThrowExpression` represent a throw expression. |
+ * |
* <pre> |
* throwExpression ::= |
- * 'throw' [Expression expression]</pre> |
+ * 'throw' [Expression] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class ThrowExpression extends Expression { |
@@ -11756,6 +13153,7 @@ class ThrowExpression extends Expression { |
/** |
* Initialize a newly created throw expression. |
+ * |
* @param keyword the token representing the 'throw' keyword |
* @param expression the expression computing the exception to be thrown |
*/ |
@@ -11766,6 +13164,7 @@ class ThrowExpression extends Expression { |
/** |
* Initialize a newly created throw expression. |
+ * |
* @param keyword the token representing the 'throw' keyword |
* @param expression the expression computing the exception to be thrown |
*/ |
@@ -11781,18 +13180,21 @@ class ThrowExpression extends Expression { |
/** |
* Return the expression computing the exception to be thrown. |
+ * |
* @return the expression computing the exception to be thrown |
*/ |
Expression get expression => _expression; |
/** |
* Return the token representing the 'throw' keyword. |
+ * |
* @return the token representing the 'throw' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Set the expression computing the exception to be thrown to the given expression. |
+ * |
* @param expression the expression computing the exception to be thrown |
*/ |
void set expression(Expression expression2) { |
@@ -11801,6 +13203,7 @@ class ThrowExpression extends Expression { |
/** |
* Set the token representing the 'throw' keyword to the given token. |
+ * |
* @param keyword the token representing the 'throw' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -11813,11 +13216,13 @@ class ThrowExpression extends Expression { |
/** |
* Instances of the class `TopLevelVariableDeclaration` represent the declaration of one or |
* more top-level variables of the same type. |
+ * |
* <pre> |
* topLevelVariableDeclaration ::= |
- * ('final' | 'const') type? staticFinalDeclarationList ';' |
- * | variableDeclaration ';' |
+ * ('final' | 'const') type? staticFinalDeclarationList ';' |
+ * | variableDeclaration ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class TopLevelVariableDeclaration extends CompilationUnitMember { |
@@ -11834,6 +13239,7 @@ class TopLevelVariableDeclaration extends CompilationUnitMember { |
/** |
* Initialize a newly created top-level variable declaration. |
+ * |
* @param comment the documentation comment associated with this variable |
* @param metadata the annotations associated with this variable |
* @param variableList the top-level variables being declared |
@@ -11846,6 +13252,7 @@ class TopLevelVariableDeclaration extends CompilationUnitMember { |
/** |
* Initialize a newly created top-level variable declaration. |
+ * |
* @param comment the documentation comment associated with this variable |
* @param metadata the annotations associated with this variable |
* @param variableList the top-level variables being declared |
@@ -11858,18 +13265,21 @@ class TopLevelVariableDeclaration extends CompilationUnitMember { |
/** |
* Return the semicolon terminating the declaration. |
+ * |
* @return the semicolon terminating the declaration |
*/ |
Token get semicolon => _semicolon; |
/** |
* Return the top-level variables being declared. |
+ * |
* @return the top-level variables being declared |
*/ |
VariableDeclarationList get variables => _variableList; |
/** |
* Set the semicolon terminating the declaration to the given token. |
+ * |
* @param semicolon the semicolon terminating the declaration |
*/ |
void set semicolon(Token semicolon2) { |
@@ -11878,6 +13288,7 @@ class TopLevelVariableDeclaration extends CompilationUnitMember { |
/** |
* Set the top-level variables being declared to the given list of variables. |
+ * |
* @param variableList the top-level variables being declared |
*/ |
void set variables(VariableDeclarationList variableList) { |
@@ -11891,11 +13302,15 @@ class TopLevelVariableDeclaration extends CompilationUnitMember { |
} |
/** |
* Instances of the class `TryStatement` represent a try statement. |
+ * |
* <pre> |
* tryStatement ::= |
- * 'try' [Block block] ([CatchClause catchClause]+ finallyClause? | finallyClause) |
+ * 'try' [Block] ([CatchClause]+ finallyClause? | finallyClause) |
+ * |
* finallyClause ::= |
- * 'finally' [Block block]</pre> |
+ * 'finally' [Block] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class TryStatement extends Statement { |
@@ -11929,6 +13344,7 @@ class TryStatement extends Statement { |
/** |
* Initialize a newly created try statement. |
+ * |
* @param tryKeyword the token representing the 'try' keyword |
* @param body the body of the statement |
* @param catchClauses the catch clauses contained in the try statement |
@@ -11946,6 +13362,7 @@ class TryStatement extends Statement { |
/** |
* Initialize a newly created try statement. |
+ * |
* @param tryKeyword the token representing the 'try' keyword |
* @param body the body of the statement |
* @param catchClauses the catch clauses contained in the try statement |
@@ -11958,12 +13375,14 @@ class TryStatement extends Statement { |
/** |
* Return the body of the statement. |
+ * |
* @return the body of the statement |
*/ |
Block get body => _body; |
/** |
* Return the catch clauses contained in the try statement. |
+ * |
* @return the catch clauses contained in the try statement |
*/ |
NodeList<CatchClause> get catchClauses => _catchClauses; |
@@ -11981,6 +13400,7 @@ class TryStatement extends Statement { |
/** |
* Return the finally clause contained in the try statement, or `null` if the statement does |
* not contain a finally clause. |
+ * |
* @return the finally clause contained in the try statement |
*/ |
Block get finallyClause => _finallyClause; |
@@ -11988,18 +13408,21 @@ class TryStatement extends Statement { |
/** |
* Return the token representing the 'finally' keyword, or `null` if the statement does not |
* contain a finally clause. |
+ * |
* @return the token representing the 'finally' keyword |
*/ |
Token get finallyKeyword => _finallyKeyword; |
/** |
* Return the token representing the 'try' keyword. |
+ * |
* @return the token representing the 'try' keyword |
*/ |
Token get tryKeyword => _tryKeyword; |
/** |
* Set the body of the statement to the given block. |
+ * |
* @param block the body of the statement |
*/ |
void set body(Block block) { |
@@ -12008,6 +13431,7 @@ class TryStatement extends Statement { |
/** |
* Set the finally clause contained in the try statement to the given block. |
+ * |
* @param block the finally clause contained in the try statement |
*/ |
void set finallyClause(Block block) { |
@@ -12016,6 +13440,7 @@ class TryStatement extends Statement { |
/** |
* Set the token representing the 'finally' keyword to the given token. |
+ * |
* @param finallyKeyword the token representing the 'finally' keyword |
*/ |
void set finallyKeyword(Token finallyKeyword2) { |
@@ -12024,6 +13449,7 @@ class TryStatement extends Statement { |
/** |
* Set the token representing the 'try' keyword to the given token. |
+ * |
* @param tryKeyword the token representing the 'try' keyword |
*/ |
void set tryKeyword(Token tryKeyword2) { |
@@ -12037,13 +13463,16 @@ class TryStatement extends Statement { |
} |
/** |
* The abstract class `TypeAlias` defines the behavior common to declarations of type aliases. |
+ * |
* <pre> |
* typeAlias ::= |
- * 'typedef' typeAliasBody |
+ * 'typedef' typeAliasBody |
+ * |
* typeAliasBody ::= |
- * classTypeAlias |
- * | functionTypeAlias |
+ * classTypeAlias |
+ * | functionTypeAlias |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class TypeAlias extends CompilationUnitMember { |
@@ -12060,6 +13489,7 @@ abstract class TypeAlias extends CompilationUnitMember { |
/** |
* Initialize a newly created type alias. |
+ * |
* @param comment the documentation comment associated with this type alias |
* @param metadata the annotations associated with this type alias |
* @param keyword the token representing the 'typedef' keyword |
@@ -12072,6 +13502,7 @@ abstract class TypeAlias extends CompilationUnitMember { |
/** |
* Initialize a newly created type alias. |
+ * |
* @param comment the documentation comment associated with this type alias |
* @param metadata the annotations associated with this type alias |
* @param keyword the token representing the 'typedef' keyword |
@@ -12082,18 +13513,21 @@ abstract class TypeAlias extends CompilationUnitMember { |
/** |
* Return the token representing the 'typedef' keyword. |
+ * |
* @return the token representing the 'typedef' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the semicolon terminating the declaration. |
+ * |
* @return the semicolon terminating the declaration |
*/ |
Token get semicolon => _semicolon; |
/** |
* Set the token representing the 'typedef' keyword to the given token. |
+ * |
* @param keyword the token representing the 'typedef' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -12102,6 +13536,7 @@ abstract class TypeAlias extends CompilationUnitMember { |
/** |
* Set the semicolon terminating the declaration to the given token. |
+ * |
* @param semicolon the semicolon terminating the declaration |
*/ |
void set semicolon(Token semicolon2) { |
@@ -12111,10 +13546,12 @@ abstract class TypeAlias extends CompilationUnitMember { |
} |
/** |
* Instances of the class `TypeArgumentList` represent a list of type arguments. |
+ * |
* <pre> |
* typeArguments ::= |
- * '<' typeName (',' typeName)* '>' |
+ * '<' typeName (',' typeName)* '>' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class TypeArgumentList extends ASTNode { |
@@ -12136,6 +13573,7 @@ class TypeArgumentList extends ASTNode { |
/** |
* Initialize a newly created list of type arguments. |
+ * |
* @param leftBracket the left bracket |
* @param arguments the type arguments associated with the type |
* @param rightBracket the right bracket |
@@ -12149,6 +13587,7 @@ class TypeArgumentList extends ASTNode { |
/** |
* Initialize a newly created list of type arguments. |
+ * |
* @param leftBracket the left bracket |
* @param arguments the type arguments associated with the type |
* @param rightBracket the right bracket |
@@ -12158,6 +13597,7 @@ class TypeArgumentList extends ASTNode { |
/** |
* Return the type arguments associated with the type. |
+ * |
* @return the type arguments associated with the type |
*/ |
NodeList<TypeName> get arguments => _arguments; |
@@ -12166,18 +13606,21 @@ class TypeArgumentList extends ASTNode { |
/** |
* Return the left bracket. |
+ * |
* @return the left bracket |
*/ |
Token get leftBracket => _leftBracket; |
/** |
* Return the right bracket. |
+ * |
* @return the right bracket |
*/ |
Token get rightBracket => _rightBracket; |
/** |
* Set the left bracket to the given token. |
+ * |
* @param leftBracket the left bracket |
*/ |
void set leftBracket(Token leftBracket2) { |
@@ -12186,6 +13629,7 @@ class TypeArgumentList extends ASTNode { |
/** |
* Set the right bracket to the given token. |
+ * |
* @param rightBracket the right bracket |
*/ |
void set rightBracket(Token rightBracket2) { |
@@ -12198,9 +13642,12 @@ class TypeArgumentList extends ASTNode { |
/** |
* Instances of the class `TypeName` represent the name of a type, which can optionally |
* include type arguments. |
+ * |
* <pre> |
- * typeName ::=[Identifier identifier] typeArguments? |
+ * typeName ::= |
+ * [Identifier] typeArguments? |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class TypeName extends ASTNode { |
@@ -12222,9 +13669,10 @@ class TypeName extends ASTNode { |
/** |
* Initialize a newly created type name. |
+ * |
* @param name the name of the type |
* @param typeArguments the type arguments associated with the type, or `null` if there are |
- * no type arguments |
+ * no type arguments |
*/ |
TypeName.full(Identifier name, TypeArgumentList typeArguments) { |
this._name = becomeParentOf(name); |
@@ -12233,9 +13681,10 @@ class TypeName extends ASTNode { |
/** |
* Initialize a newly created type name. |
+ * |
* @param name the name of the type |
* @param typeArguments the type arguments associated with the type, or `null` if there are |
- * no type arguments |
+ * no type arguments |
*/ |
TypeName({Identifier name, TypeArgumentList typeArguments}) : this.full(name, typeArguments); |
accept(ASTVisitor visitor) => visitor.visitTypeName(this); |
@@ -12249,12 +13698,14 @@ class TypeName extends ASTNode { |
/** |
* Return the name of the type. |
+ * |
* @return the name of the type |
*/ |
Identifier get name => _name; |
/** |
* Return the type being named, or `null` if the AST structure has not been resolved. |
+ * |
* @return the type being named |
*/ |
Type2 get type => _type; |
@@ -12262,6 +13713,7 @@ class TypeName extends ASTNode { |
/** |
* Return the type arguments associated with the type, or `null` if there are no type |
* arguments. |
+ * |
* @return the type arguments associated with the type |
*/ |
TypeArgumentList get typeArguments => _typeArguments; |
@@ -12269,6 +13721,7 @@ class TypeName extends ASTNode { |
/** |
* Set the name of the type to the given identifier. |
+ * |
* @param identifier the name of the type |
*/ |
void set name(Identifier identifier) { |
@@ -12277,6 +13730,7 @@ class TypeName extends ASTNode { |
/** |
* Set the type being named to the given type. |
+ * |
* @param type the type being named |
*/ |
void set type(Type2 type2) { |
@@ -12285,6 +13739,7 @@ class TypeName extends ASTNode { |
/** |
* Set the type arguments associated with the type to the given type arguments. |
+ * |
* @param typeArguments the type arguments associated with the type |
*/ |
void set typeArguments(TypeArgumentList typeArguments2) { |
@@ -12297,9 +13752,12 @@ class TypeName extends ASTNode { |
} |
/** |
* Instances of the class `TypeParameter` represent a type parameter. |
+ * |
* <pre> |
- * typeParameter ::=[SimpleIdentifier name] ('extends' [TypeName bound])? |
+ * typeParameter ::= |
+ * [SimpleIdentifier] ('extends' [TypeName])? |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class TypeParameter extends Declaration { |
@@ -12323,6 +13781,7 @@ class TypeParameter extends Declaration { |
/** |
* Initialize a newly created type parameter. |
+ * |
* @param comment the documentation comment associated with the type parameter |
* @param metadata the annotations associated with the type parameter |
* @param name the name of the type parameter |
@@ -12337,6 +13796,7 @@ class TypeParameter extends Declaration { |
/** |
* Initialize a newly created type parameter. |
+ * |
* @param comment the documentation comment associated with the type parameter |
* @param metadata the annotations associated with the type parameter |
* @param name the name of the type parameter |
@@ -12349,6 +13809,7 @@ class TypeParameter extends Declaration { |
/** |
* Return the name of the upper bound for legal arguments, or `null` if there was no |
* explicit upper bound. |
+ * |
* @return the name of the upper bound for legal arguments |
*/ |
TypeName get bound => _bound; |
@@ -12362,18 +13823,21 @@ class TypeParameter extends Declaration { |
/** |
* Return the token representing the 'assert' keyword. |
+ * |
* @return the token representing the 'assert' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the name of the type parameter. |
+ * |
* @return the name of the type parameter |
*/ |
SimpleIdentifier get name => _name; |
/** |
* Set the name of the upper bound for legal arguments to the given type name. |
+ * |
* @param typeName the name of the upper bound for legal arguments |
*/ |
void set bound(TypeName typeName) { |
@@ -12382,6 +13846,7 @@ class TypeParameter extends Declaration { |
/** |
* Set the token representing the 'assert' keyword to the given token. |
+ * |
* @param keyword the token representing the 'assert' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -12390,6 +13855,7 @@ class TypeParameter extends Declaration { |
/** |
* Set the name of the type parameter to the given identifier. |
+ * |
* @param identifier the name of the type parameter |
*/ |
void set name(SimpleIdentifier identifier) { |
@@ -12404,10 +13870,12 @@ class TypeParameter extends Declaration { |
} |
/** |
* Instances of the class `TypeParameterList` represent type parameters within a declaration. |
+ * |
* <pre> |
* typeParameterList ::= |
- * '<' [TypeParameter typeParameter] (',' [TypeParameter typeParameter])* '>' |
+ * '<' [TypeParameter] (',' [TypeParameter])* '>' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class TypeParameterList extends ASTNode { |
@@ -12429,6 +13897,7 @@ class TypeParameterList extends ASTNode { |
/** |
* Initialize a newly created list of type parameters. |
+ * |
* @param leftBracket the left angle bracket |
* @param typeParameters the type parameters in the list |
* @param rightBracket the right angle bracket |
@@ -12442,6 +13911,7 @@ class TypeParameterList extends ASTNode { |
/** |
* Initialize a newly created list of type parameters. |
+ * |
* @param leftBracket the left angle bracket |
* @param typeParameters the type parameters in the list |
* @param rightBracket the right angle bracket |
@@ -12453,18 +13923,21 @@ class TypeParameterList extends ASTNode { |
/** |
* Return the left angle bracket. |
+ * |
* @return the left angle bracket |
*/ |
Token get leftBracket => _leftBracket; |
/** |
* Return the right angle bracket. |
+ * |
* @return the right angle bracket |
*/ |
Token get rightBracket => _rightBracket; |
/** |
* Return the type parameters for the type. |
+ * |
* @return the type parameters for the type |
*/ |
NodeList<TypeParameter> get typeParameters => _typeParameters; |
@@ -12475,8 +13948,13 @@ class TypeParameterList extends ASTNode { |
/** |
* The abstract class `TypedLiteral` defines the behavior common to literals that have a type |
* associated with them. |
+ * |
* <pre> |
- * listLiteral ::=[ListLiteral listLiteral]| [MapLiteral mapLiteral]</pre> |
+ * listLiteral ::= |
+ * [ListLiteral] |
+ * | [MapLiteral] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class TypedLiteral extends Literal { |
@@ -12495,9 +13973,10 @@ abstract class TypedLiteral extends Literal { |
/** |
* Initialize a newly created typed literal. |
+ * |
* @param modifier the const modifier associated with this literal |
* @param typeArguments the type argument associated with this literal, or `null` if no type |
- * arguments were declared |
+ * arguments were declared |
*/ |
TypedLiteral.full(Token modifier, TypeArgumentList typeArguments) { |
this._modifier = modifier; |
@@ -12506,14 +13985,16 @@ abstract class TypedLiteral extends Literal { |
/** |
* Initialize a newly created typed literal. |
+ * |
* @param modifier the const modifier associated with this literal |
* @param typeArguments the type argument associated with this literal, or `null` if no type |
- * arguments were declared |
+ * arguments were declared |
*/ |
TypedLiteral({Token modifier, TypeArgumentList typeArguments}) : this.full(modifier, typeArguments); |
/** |
* Return the const modifier associated with this literal. |
+ * |
* @return the const modifier associated with this literal |
*/ |
Token get modifier => _modifier; |
@@ -12521,12 +14002,14 @@ abstract class TypedLiteral extends Literal { |
/** |
* Return the type argument associated with this literal, or `null` if no type arguments |
* were declared. |
+ * |
* @return the type argument associated with this literal |
*/ |
TypeArgumentList get typeArguments => _typeArguments; |
/** |
* Set the modifiers associated with this literal to the given modifiers. |
+ * |
* @param modifiers the modifiers associated with this literal |
*/ |
void set modifier(Token modifier2) { |
@@ -12535,6 +14018,7 @@ abstract class TypedLiteral extends Literal { |
/** |
* Set the type argument associated with this literal to the given arguments. |
+ * |
* @param typeArguments the type argument associated with this literal |
*/ |
void set typeArguments(TypeArgumentList typeArguments2) { |
@@ -12547,8 +14031,14 @@ abstract class TypedLiteral extends Literal { |
/** |
* The abstract class `UriBasedDirective` defines the behavior common to nodes that represent |
* a directive that references a URI. |
+ * |
* <pre> |
- * uriBasedDirective ::=[ExportDirective exportDirective]| [ImportDirective importDirective]| [PartDirective partDirective]</pre> |
+ * uriBasedDirective ::= |
+ * [ExportDirective] |
+ * | [ImportDirective] |
+ * | [PartDirective] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
abstract class UriBasedDirective extends Directive { |
@@ -12560,6 +14050,7 @@ abstract class UriBasedDirective extends Directive { |
/** |
* Initialize a newly create URI-based directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param uri the URI referenced by this directive |
@@ -12570,6 +14061,7 @@ abstract class UriBasedDirective extends Directive { |
/** |
* Initialize a newly create URI-based directive. |
+ * |
* @param comment the documentation comment associated with this directive |
* @param metadata the annotations associated with the directive |
* @param uri the URI referenced by this directive |
@@ -12578,6 +14070,7 @@ abstract class UriBasedDirective extends Directive { |
/** |
* Return the URI referenced by this directive. |
+ * |
* @return the URI referenced by this directive |
*/ |
StringLiteral get uri => _uri; |
@@ -12586,12 +14079,14 @@ abstract class UriBasedDirective extends Directive { |
* Return the element associated with the URI of this directive, or `null` if the AST |
* structure has not been resolved or if this URI could not be resolved. Examples of the latter |
* case include a directive that contains an invalid URL or a URL that does not exist. |
+ * |
* @return the element associated with this directive |
*/ |
Element get uriElement; |
/** |
* Set the URI referenced by this directive to the given URI. |
+ * |
* @param uri the URI referenced by this directive |
*/ |
void set uri(StringLiteral uri2) { |
@@ -12604,10 +14099,14 @@ abstract class UriBasedDirective extends Directive { |
} |
/** |
* Instances of the class `VariableDeclaration` represent an identifier that has an initial |
- * value associated with it. Instances of this class are always children of the class[VariableDeclarationList]. |
+ * value associated with it. Instances of this class are always children of the class |
+ * [VariableDeclarationList]. |
+ * |
* <pre> |
- * variableDeclaration ::=[SimpleIdentifier identifier] ('=' [Expression initialValue])? |
+ * variableDeclaration ::= |
+ * [SimpleIdentifier] ('=' [Expression])? |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class VariableDeclaration extends Declaration { |
@@ -12631,6 +14130,7 @@ class VariableDeclaration extends Declaration { |
/** |
* Initialize a newly created variable declaration. |
+ * |
* @param comment the documentation comment associated with this declaration |
* @param metadata the annotations associated with this member |
* @param name the name of the variable being declared |
@@ -12645,6 +14145,7 @@ class VariableDeclaration extends Declaration { |
/** |
* Initialize a newly created variable declaration. |
+ * |
* @param comment the documentation comment associated with this declaration |
* @param metadata the annotations associated with this member |
* @param name the name of the variable being declared |
@@ -12681,6 +14182,7 @@ class VariableDeclaration extends Declaration { |
/** |
* Return the equal sign separating the variable name from the initial value, or `null` if |
* the initial value was not specified. |
+ * |
* @return the equal sign separating the variable name from the initial value |
*/ |
Token get equals => _equals; |
@@ -12688,18 +14190,21 @@ class VariableDeclaration extends Declaration { |
/** |
* Return the expression used to compute the initial value for the variable, or `null` if |
* the initial value was not specified. |
+ * |
* @return the expression used to compute the initial value for the variable |
*/ |
Expression get initializer => _initializer; |
/** |
* Return the name of the variable being declared. |
+ * |
* @return the name of the variable being declared |
*/ |
SimpleIdentifier get name => _name; |
/** |
* Return `true` if this variable was declared with the 'const' modifier. |
+ * |
* @return `true` if this variable was declared with the 'const' modifier |
*/ |
bool get isConst { |
@@ -12711,6 +14216,7 @@ class VariableDeclaration extends Declaration { |
* Return `true` if this variable was declared with the 'final' modifier. Variables that are |
* declared with the 'const' modifier will return `false` even though they are implicitly |
* final. |
+ * |
* @return `true` if this variable was declared with the 'final' modifier |
*/ |
bool get isFinal { |
@@ -12720,6 +14226,7 @@ class VariableDeclaration extends Declaration { |
/** |
* Set the equal sign separating the variable name from the initial value to the given token. |
+ * |
* @param equals the equal sign separating the variable name from the initial value |
*/ |
void set equals(Token equals2) { |
@@ -12728,6 +14235,7 @@ class VariableDeclaration extends Declaration { |
/** |
* Set the expression used to compute the initial value for the variable to the given expression. |
+ * |
* @param initializer the expression used to compute the initial value for the variable |
*/ |
void set initializer(Expression initializer2) { |
@@ -12736,6 +14244,7 @@ class VariableDeclaration extends Declaration { |
/** |
* Set the name of the variable being declared to the given identifier. |
+ * |
* @param name the name of the variable being declared |
*/ |
void set name(SimpleIdentifier name2) { |
@@ -12751,14 +14260,18 @@ class VariableDeclaration extends Declaration { |
/** |
* Instances of the class `VariableDeclarationList` represent the declaration of one or more |
* variables of the same type. |
+ * |
* <pre> |
* variableDeclarationList ::= |
- * finalConstVarOrType [VariableDeclaration variableDeclaration] (',' [VariableDeclaration variableDeclaration]) |
+ * finalConstVarOrType [VariableDeclaration] (',' [VariableDeclaration])* |
+ * |
* finalConstVarOrType ::= |
- * | 'final' [TypeName type]? |
- * | 'const' [TypeName type]? |
- * | 'var' |
- * | [TypeName type]</pre> |
+ * | 'final' [TypeName]? |
+ * | 'const' [TypeName]? |
+ * | 'var' |
+ * | [TypeName] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class VariableDeclarationList extends AnnotatedNode { |
@@ -12781,6 +14294,7 @@ class VariableDeclarationList extends AnnotatedNode { |
/** |
* Initialize a newly created variable declaration list. |
+ * |
* @param comment the documentation comment associated with this declaration list |
* @param metadata the annotations associated with this declaration list |
* @param keyword the token representing the 'final', 'const' or 'var' keyword |
@@ -12796,6 +14310,7 @@ class VariableDeclarationList extends AnnotatedNode { |
/** |
* Initialize a newly created variable declaration list. |
+ * |
* @param comment the documentation comment associated with this declaration list |
* @param metadata the annotations associated with this declaration list |
* @param keyword the token representing the 'final', 'const' or 'var' keyword |
@@ -12809,24 +14324,28 @@ class VariableDeclarationList extends AnnotatedNode { |
/** |
* Return the token representing the 'final', 'const' or 'var' keyword, or `null` if no |
* keyword was included. |
+ * |
* @return the token representing the 'final', 'const' or 'var' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the type of the variables being declared, or `null` if no type was provided. |
+ * |
* @return the type of the variables being declared |
*/ |
TypeName get type => _type; |
/** |
* Return a list containing the individual variables being declared. |
+ * |
* @return a list containing the individual variables being declared |
*/ |
NodeList<VariableDeclaration> get variables => _variables; |
/** |
* Return `true` if the variables in this list were declared with the 'const' modifier. |
+ * |
* @return `true` if the variables in this list were declared with the 'const' modifier |
*/ |
bool get isConst => _keyword is KeywordToken && identical(((_keyword as KeywordToken)).keyword, Keyword.CONST); |
@@ -12835,12 +14354,14 @@ class VariableDeclarationList extends AnnotatedNode { |
* Return `true` if the variables in this list were declared with the 'final' modifier. |
* Variables that are declared with the 'const' modifier will return `false` even though |
* they are implicitly final. |
+ * |
* @return `true` if the variables in this list were declared with the 'final' modifier |
*/ |
bool get isFinal => _keyword is KeywordToken && identical(((_keyword as KeywordToken)).keyword, Keyword.FINAL); |
/** |
* Set the token representing the 'final', 'const' or 'var' keyword to the given token. |
+ * |
* @param keyword the token representing the 'final', 'const' or 'var' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -12849,6 +14370,7 @@ class VariableDeclarationList extends AnnotatedNode { |
/** |
* Set the type of the variables being declared to the given type name. |
+ * |
* @param typeName the type of the variables being declared |
*/ |
void set type(TypeName typeName) { |
@@ -12870,9 +14392,12 @@ class VariableDeclarationList extends AnnotatedNode { |
/** |
* Instances of the class `VariableDeclarationStatement` represent a list of variables that |
* are being declared in a context where a statement is required. |
+ * |
* <pre> |
- * variableDeclarationStatement ::=[VariableDeclarationList variableList] ';' |
+ * variableDeclarationStatement ::= |
+ * [VariableDeclarationList] ';' |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class VariableDeclarationStatement extends Statement { |
@@ -12889,6 +14414,7 @@ class VariableDeclarationStatement extends Statement { |
/** |
* Initialize a newly created variable declaration statement. |
+ * |
* @param variableList the fields being declared |
* @param semicolon the semicolon terminating the statement |
*/ |
@@ -12899,6 +14425,7 @@ class VariableDeclarationStatement extends Statement { |
/** |
* Initialize a newly created variable declaration statement. |
+ * |
* @param variableList the fields being declared |
* @param semicolon the semicolon terminating the statement |
*/ |
@@ -12909,18 +14436,21 @@ class VariableDeclarationStatement extends Statement { |
/** |
* Return the semicolon terminating the statement. |
+ * |
* @return the semicolon terminating the statement |
*/ |
Token get semicolon => _semicolon; |
/** |
* Return the variables being declared. |
+ * |
* @return the variables being declared |
*/ |
VariableDeclarationList get variables => _variableList; |
/** |
* Set the semicolon terminating the statement to the given token. |
+ * |
* @param semicolon the semicolon terminating the statement |
*/ |
void set semicolon(Token semicolon2) { |
@@ -12929,6 +14459,7 @@ class VariableDeclarationStatement extends Statement { |
/** |
* Set the variables being declared to the given list of variables. |
+ * |
* @param variableList the variables being declared |
*/ |
void set variables(VariableDeclarationList variableList2) { |
@@ -12940,9 +14471,12 @@ class VariableDeclarationStatement extends Statement { |
} |
/** |
* Instances of the class `WhileStatement` represent a while statement. |
+ * |
* <pre> |
* whileStatement ::= |
- * 'while' '(' [Expression condition] ')' [Statement body]</pre> |
+ * 'while' '(' [Expression] ')' [Statement] |
+ * </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class WhileStatement extends Statement { |
@@ -12974,6 +14508,7 @@ class WhileStatement extends Statement { |
/** |
* Initialize a newly created while statement. |
+ * |
* @param keyword the token representing the 'while' keyword |
* @param leftParenthesis the left parenthesis |
* @param condition the expression used to determine whether to execute the body of the loop |
@@ -12990,6 +14525,7 @@ class WhileStatement extends Statement { |
/** |
* Initialize a newly created while statement. |
+ * |
* @param keyword the token representing the 'while' keyword |
* @param leftParenthesis the left parenthesis |
* @param condition the expression used to determine whether to execute the body of the loop |
@@ -13002,12 +14538,14 @@ class WhileStatement extends Statement { |
/** |
* Return the body of the loop. |
+ * |
* @return the body of the loop |
*/ |
Statement get body => _body; |
/** |
* Return the expression used to determine whether to execute the body of the loop. |
+ * |
* @return the expression used to determine whether to execute the body of the loop |
*/ |
Expression get condition => _condition; |
@@ -13015,24 +14553,28 @@ class WhileStatement extends Statement { |
/** |
* Return the token representing the 'while' keyword. |
+ * |
* @return the token representing the 'while' keyword |
*/ |
Token get keyword => _keyword; |
/** |
* Return the left parenthesis. |
+ * |
* @return the left parenthesis |
*/ |
Token get leftParenthesis => _leftParenthesis; |
/** |
* Return the right parenthesis. |
+ * |
* @return the right parenthesis |
*/ |
Token get rightParenthesis => _rightParenthesis; |
/** |
* Set the body of the loop to the given statement. |
+ * |
* @param statement the body of the loop |
*/ |
void set body(Statement statement) { |
@@ -13042,6 +14584,7 @@ class WhileStatement extends Statement { |
/** |
* Set the expression used to determine whether to execute the body of the loop to the given |
* expression. |
+ * |
* @param expression the expression used to determine whether to execute the body of the loop |
*/ |
void set condition(Expression expression) { |
@@ -13050,6 +14593,7 @@ class WhileStatement extends Statement { |
/** |
* Set the token representing the 'while' keyword to the given token. |
+ * |
* @param keyword the token representing the 'while' keyword |
*/ |
void set keyword(Token keyword2) { |
@@ -13058,6 +14602,7 @@ class WhileStatement extends Statement { |
/** |
* Set the left parenthesis to the given token. |
+ * |
* @param leftParenthesis the left parenthesis |
*/ |
void set leftParenthesis(Token leftParenthesis2) { |
@@ -13066,6 +14611,7 @@ class WhileStatement extends Statement { |
/** |
* Set the right parenthesis to the given token. |
+ * |
* @param rightParenthesis the right parenthesis |
*/ |
void set rightParenthesis(Token rightParenthesis2) { |
@@ -13078,10 +14624,12 @@ class WhileStatement extends Statement { |
} |
/** |
* Instances of the class `WithClause` represent the with clause in a class declaration. |
+ * |
* <pre> |
* withClause ::= |
- * 'with' [TypeName mixin] (',' [TypeName mixin]) |
+ * 'with' [TypeName] (',' [TypeName])* |
* </pre> |
+ * |
* @coverage dart.engine.ast |
*/ |
class WithClause extends ASTNode { |
@@ -13098,6 +14646,7 @@ class WithClause extends ASTNode { |
/** |
* Initialize a newly created with clause. |
+ * |
* @param withKeyword the token representing the 'with' keyword |
* @param mixinTypes the names of the mixins that were specified |
*/ |
@@ -13109,6 +14658,7 @@ class WithClause extends ASTNode { |
/** |
* Initialize a newly created with clause. |
+ * |
* @param withKeyword the token representing the 'with' keyword |
* @param mixinTypes the names of the mixins that were specified |
*/ |
@@ -13119,18 +14669,21 @@ class WithClause extends ASTNode { |
/** |
* Return the names of the mixins that were specified. |
+ * |
* @return the names of the mixins that were specified |
*/ |
NodeList<TypeName> get mixinTypes => _mixinTypes; |
/** |
* Return the token representing the 'with' keyword. |
+ * |
* @return the token representing the 'with' keyword |
*/ |
Token get withKeyword => _withKeyword; |
/** |
* Set the token representing the 'with' keyword to the given token. |
+ * |
* @param withKeyword the token representing the 'with' keyword |
*/ |
void set mixinKeyword(Token withKeyword2) { |
@@ -13143,7 +14696,9 @@ class WithClause extends ASTNode { |
/** |
* Instances of the class `BreadthFirstVisitor` implement an AST visitor that will recursively |
* visit all of the nodes in an AST structure, similar to [GeneralizingASTVisitor]. This |
- * visitor uses a breadth-first ordering rather than the depth-first ordering of[GeneralizingASTVisitor]. |
+ * visitor uses a breadth-first ordering rather than the depth-first ordering of |
+ * [GeneralizingASTVisitor]. |
+ * |
* @coverage dart.engine.ast |
*/ |
class BreadthFirstVisitor<R> extends GeneralizingASTVisitor<R> { |
@@ -13152,6 +14707,7 @@ class BreadthFirstVisitor<R> extends GeneralizingASTVisitor<R> { |
/** |
* Visit all nodes in the tree starting at the given `root` node, in depth-first order. |
+ * |
* @param root the root of the ASTNode tree |
*/ |
void visitAllNodes(ASTNode root) { |
@@ -13194,19 +14750,28 @@ class GeneralizingASTVisitor_1 extends GeneralizingASTVisitor<Object> { |
* * A constant map literal. |
* * A simple or qualified identifier denoting a top-level function or a static method. |
* * A parenthesized expression `(e)` where `e` is a constant expression. |
- * * An expression of one of the forms `identical(e1, e2)`, `e1 == e2`,`e1 != e2` where `e1` and `e2` are constant expressions that evaluate to a |
+ * * An expression of one of the forms `identical(e1, e2)`, `e1 == e2`, |
+ * `e1 != e2` where `e1` and `e2` are constant expressions that evaluate to a |
* numeric, string or boolean value or to `null`. |
- * * An expression of one of the forms `!e`, `e1 && e2` or `e1 || e2`, where`e`, `e1` and `e2` are constant expressions that evaluate to a boolean value or |
+ * * An expression of one of the forms `!e`, `e1 && e2` or `e1 || e2`, where |
+ * `e`, `e1` and `e2` are constant expressions that evaluate to a boolean value or |
* to `null`. |
- * * An expression of one of the forms `~e`, `e1 ^ e2`, `e1 & e2`,`e1 | e2`, `e1 >> e2` or `e1 << e2`, where `e`, `e1` and `e2`are constant expressions that evaluate to an integer value or to `null`. |
- * * An expression of one of the forms `-e`, `e1 + e2`, `e1 - e2`,`e1 * e2`, `e1 / e2`, `e1 ~/ e2`, `e1 > e2`, `e1 < e2`,`e1 >= e2`, `e1 <= e2` or `e1 % e2`, where `e`, `e1` and `e2`are constant expressions that evaluate to a numeric value or to `null`. |
+ * * An expression of one of the forms `~e`, `e1 ^ e2`, `e1 & e2`, |
+ * `e1 | e2`, `e1 >> e2` or `e1 << e2`, where `e`, `e1` and `e2` |
+ * are constant expressions that evaluate to an integer value or to `null`. |
+ * * An expression of one of the forms `-e`, `e1 + e2`, `e1 - e2`, |
+ * `e1 * e2`, `e1 / e2`, `e1 ~/ e2`, `e1 > e2`, `e1 < e2`, |
+ * `e1 >= e2`, `e1 <= e2` or `e1 % e2`, where `e`, `e1` and `e2` |
+ * are constant expressions that evaluate to a numeric value or to `null`. |
* |
* </blockquote> The values returned by instances of this class are therefore `null` and |
- * instances of the classes `Boolean`, `BigInteger`, `Double`, `String`, and`DartObject`. |
+ * instances of the classes `Boolean`, `BigInteger`, `Double`, `String`, and |
+ * `DartObject`. |
* |
* In addition, this class defines several values that can be returned to indicate various |
* conditions encountered during evaluation. These are documented with the static field that define |
* those values. |
+ * |
* @coverage dart.engine.ast |
*/ |
class ConstantEvaluator extends GeneralizingASTVisitor<Object> { |
@@ -13443,6 +15008,7 @@ class ConstantEvaluator extends GeneralizingASTVisitor<Object> { |
/** |
* Return the constant value of the static constant represented by the given element. |
+ * |
* @param element the element whose value is to be returned |
* @return the constant value of the static constant |
*/ |
@@ -13456,14 +15022,16 @@ class ConstantEvaluator extends GeneralizingASTVisitor<Object> { |
} |
} |
/** |
- * Instances of the class `ElementLocator` locate the [Element Dart model element]associated with a given [ASTNode AST node]. |
+ * Instances of the class `ElementLocator` locate the [Element] |
+ * associated with a given [ASTNode]. |
+ * |
* @coverage dart.engine.ast |
*/ |
class ElementLocator { |
/** |
- * Locate the [Element Dart model element] associated with the given [ASTNode AST |
- * node]. |
+ * Locate the [Element] associated with the given [ASTNode]. |
+ * |
* @param node the node (not `null`) |
* @return the associated element, or `null` if none is found |
*/ |
@@ -13528,7 +15096,8 @@ class ElementLocator_ElementMapper extends GeneralizingASTVisitor<Element> { |
} |
/** |
* Instances of the class `GeneralizingASTVisitor` implement an AST visitor that will |
- * recursively visit all of the nodes in an AST structure (like instances of the class[RecursiveASTVisitor]). In addition, when a node of a specific type is visited not only |
+ * recursively visit all of the nodes in an AST structure (like instances of the class |
+ * [RecursiveASTVisitor]). In addition, when a node of a specific type is visited not only |
* will the visit method for that specific type of node be invoked, but additional methods for the |
* superclasses of that node will also be invoked. For example, using an instance of this class to |
* visit a [Block] will cause the method [visitBlock] to be invoked but will |
@@ -13540,6 +15109,7 @@ class ElementLocator_ElementMapper extends GeneralizingASTVisitor<Element> { |
* explicitly invoke the more general visit method. Failure to do so will cause the visit methods |
* for superclasses of the node to not be invoked and will cause the children of the visited node to |
* not be visited. |
+ * |
* @coverage dart.engine.ast |
*/ |
class GeneralizingASTVisitor<R> implements ASTVisitor<R> { |
@@ -13671,10 +15241,11 @@ class GeneralizingASTVisitor<R> implements ASTVisitor<R> { |
R visitWithClause(WithClause node) => visitNode(node); |
} |
/** |
- * Instances of the class `NodeLocator` locate the [ASTNode AST node] associated with a |
+ * Instances of the class `NodeLocator` locate the [ASTNode] associated with a |
* source range, given the AST structure built from the source. More specifically, they will return |
- * the [ASTNode AST node] with the shortest length whose source range completely encompasses |
+ * the [ASTNode] with the shortest length whose source range completely encompasses |
* the specified range. |
+ * |
* @coverage dart.engine.ast |
*/ |
class NodeLocator extends GeneralizingASTVisitor<Object> { |
@@ -13696,8 +15267,9 @@ class NodeLocator extends GeneralizingASTVisitor<Object> { |
ASTNode _foundNode; |
/** |
- * Initialize a newly created locator to locate one or more [ASTNode AST nodes] by locating |
+ * Initialize a newly created locator to locate one or more [ASTNode] by locating |
* the node within an AST structure that corresponds to the given offset in the source. |
+ * |
* @param offset the offset used to identify the node |
*/ |
NodeLocator.con1(int offset) { |
@@ -13708,9 +15280,10 @@ class NodeLocator extends GeneralizingASTVisitor<Object> { |
} |
/** |
- * Initialize a newly created locator to locate one or more [ASTNode AST nodes] by locating |
+ * Initialize a newly created locator to locate one or more [ASTNode] by locating |
* the node within an AST structure that corresponds to the given range of characters in the |
* source. |
+ * |
* @param start the start offset of the range used to identify the node |
* @param end the end offset of the range used to identify the node |
*/ |
@@ -13725,14 +15298,15 @@ class NodeLocator extends GeneralizingASTVisitor<Object> { |
/** |
* Return the node that was found that corresponds to the given source range, or `null` if |
* there is no such node. |
+ * |
* @return the node that was found |
*/ |
ASTNode get foundNode => _foundNode; |
/** |
- * Search within the given AST node for an identifier representing a [DartElement Dart |
- * element] in the specified source range. Return the element that was found, or `null` if |
+ * Search within the given AST node for an identifier representing a [DartElement] in the specified source range. Return the element that was found, or `null` if |
* no element was found. |
+ * |
* @param node the AST node within which to search |
* @return the element that was found |
*/ |
@@ -13784,6 +15358,7 @@ class NodeLocator_NodeFoundException extends RuntimeException { |
* Subclasses that override a visit method must either invoke the overridden visit method or must |
* explicitly ask the visited node to visit its children. Failure to do so will cause the children |
* of the visited node to not be visited. |
+ * |
* @coverage dart.engine.ast |
*/ |
class RecursiveASTVisitor<R> implements ASTVisitor<R> { |
@@ -14197,6 +15772,7 @@ class RecursiveASTVisitor<R> implements ASTVisitor<R> { |
* when visiting an AST node. It is intended to be a superclass for classes that use the visitor |
* pattern primarily as a dispatch mechanism (and hence don't need to recursively visit a whole |
* structure) and that only need to visit a small number of node types. |
+ * |
* @coverage dart.engine.ast |
*/ |
class SimpleASTVisitor<R> implements ASTVisitor<R> { |
@@ -14305,6 +15881,7 @@ class SimpleASTVisitor<R> implements ASTVisitor<R> { |
/** |
* Instances of the class `ToSourceVisitor` write a source representation of a visited AST |
* node (and all of it's children) to a writer. |
+ * |
* @coverage dart.engine.ast |
*/ |
class ToSourceVisitor implements ASTVisitor<Object> { |
@@ -14317,6 +15894,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Initialize a newly created visitor to write source code representing the visited nodes to the |
* given writer. |
+ * |
* @param writer the writer to which the source is to be written |
*/ |
ToSourceVisitor(PrintWriter writer) { |
@@ -15008,6 +16586,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Safely visit the given node. |
+ * |
* @param node the node to be visited |
*/ |
void visit(ASTNode node) { |
@@ -15018,6 +16597,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Safely visit the given node, printing the suffix after the node if it is non-`null`. |
+ * |
* @param suffix the suffix to be printed if there is a node to visit |
* @param node the node to be visited |
*/ |
@@ -15030,6 +16610,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Safely visit the given node, printing the prefix before the node if it is non-`null`. |
+ * |
* @param prefix the prefix to be printed if there is a node to visit |
* @param node the node to be visited |
*/ |
@@ -15042,6 +16623,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Visit the given function body, printing the prefix before if given body is not empty. |
+ * |
* @param prefix the prefix to be printed if there is a node to visit |
* @param body the function body to be visited |
*/ |
@@ -15054,6 +16636,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Safely visit the given node, printing the suffix after the node if it is non-`null`. |
+ * |
* @param suffix the suffix to be printed if there is a node to visit |
* @param node the node to be visited |
*/ |
@@ -15066,6 +16649,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Print a list of nodes without any separation. |
+ * |
* @param nodes the nodes to be printed |
* @param separator the separator to be printed between adjacent nodes |
*/ |
@@ -15075,6 +16659,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Print a list of nodes, separated by the given separator. |
+ * |
* @param nodes the nodes to be printed |
* @param separator the separator to be printed between adjacent nodes |
*/ |
@@ -15092,6 +16677,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Print a list of nodes, separated by the given separator. |
+ * |
* @param nodes the nodes to be printed |
* @param separator the separator to be printed between adjacent nodes |
* @param suffix the suffix to be printed if the list is not empty |
@@ -15113,6 +16699,7 @@ class ToSourceVisitor implements ASTVisitor<Object> { |
/** |
* Print a list of nodes, separated by the given separator. |
+ * |
* @param prefix the prefix to be printed if the list is not empty |
* @param nodes the nodes to be printed |
* @param separator the separator to be printed between adjacent nodes |
@@ -15280,6 +16867,7 @@ class ASTCloner implements ASTVisitor<ASTNode> { |
* |
* Completion test code coverage is 95%. The two basic blocks that are not executed cannot be |
* executed. They are included for future reference. |
+ * |
* @coverage com.google.dart.engine.services.completion |
*/ |
class ScopedNameFinder extends GeneralizingASTVisitor<Object> { |
@@ -15391,6 +16979,7 @@ class ScopedNameFinder extends GeneralizingASTVisitor<Object> { |
/** |
* Some statements define names that are visible downstream. There aren't many of these. |
+ * |
* @param statements the list of statements to check for name definitions |
*/ |
void checkStatements(List<Statement> statements) { |