OLD | NEW |
1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2014, the Dart project authors. Please see the AUTHORS file |
2 // for details. All rights reserved. Use of this source code is governed by a | 2 // for details. All rights reserved. Use of this source code is governed by a |
3 // BSD-style license that can be found in the LICENSE file. | 3 // BSD-style license that can be found in the LICENSE file. |
4 | 4 |
5 /** | 5 /** |
6 * Defines the AST model. The AST (Abstract Syntax Tree) model describes the | 6 * Defines the AST model. The AST (Abstract Syntax Tree) model describes the |
7 * syntactic (as opposed to semantic) structure of Dart code. The semantic | 7 * syntactic (as opposed to semantic) structure of Dart code. The semantic |
8 * structure of the code is modeled by the | 8 * structure of the code is modeled by the |
9 * [element model](../element/element.dart). | 9 * [element model](../element/element.dart). |
10 * | 10 * |
(...skipping 499 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
510 * Return the node at the root of this node's AST structure. Note that this | 510 * Return the node at the root of this node's AST structure. Note that this |
511 * method's performance is linear with respect to the depth of the node in the | 511 * method's performance is linear with respect to the depth of the node in the |
512 * AST structure (O(depth)). | 512 * AST structure (O(depth)). |
513 */ | 513 */ |
514 AstNode get root; | 514 AstNode get root; |
515 | 515 |
516 /** | 516 /** |
517 * Use the given [visitor] to visit this node. Return the value returned by | 517 * Use the given [visitor] to visit this node. Return the value returned by |
518 * the visitor as a result of visiting this node. | 518 * the visitor as a result of visiting this node. |
519 */ | 519 */ |
520 dynamic/*=E*/ accept/*<E>*/(AstVisitor/*<E>*/ visitor); | 520 E accept<E>(AstVisitor<E> visitor); |
521 | 521 |
522 /** | 522 /** |
523 * Return the most immediate ancestor of this node for which the [predicate] | 523 * Return the most immediate ancestor of this node for which the [predicate] |
524 * returns `true`, or `null` if there is no such ancestor. Note that this node | 524 * returns `true`, or `null` if there is no such ancestor. Note that this node |
525 * will never be returned. | 525 * will never be returned. |
526 */ | 526 */ |
527 AstNode/*=E*/ getAncestor/*<E extends AstNode>*/( | 527 E getAncestor<E extends AstNode>(Predicate<AstNode> predicate); |
528 Predicate<AstNode> predicate); | |
529 | 528 |
530 /** | 529 /** |
531 * Return the value of the property with the given [name], or `null` if this | 530 * Return the value of the property with the given [name], or `null` if this |
532 * node does not have a property with the given name. | 531 * node does not have a property with the given name. |
533 */ | 532 */ |
534 Object/*=E*/ getProperty/*<E>*/(String name); | 533 E getProperty<E>(String name); |
535 | 534 |
536 /** | 535 /** |
537 * Set the value of the property with the given [name] to the given [value]. | 536 * Set the value of the property with the given [name] to the given [value]. |
538 * If the value is `null`, the property will effectively be removed. | 537 * If the value is `null`, the property will effectively be removed. |
539 */ | 538 */ |
540 void setProperty(String name, Object value); | 539 void setProperty(String name, Object value); |
541 | 540 |
542 /** | 541 /** |
543 * Return a textual description of this node in a form approximating valid | 542 * Return a textual description of this node in a form approximating valid |
544 * source. The returned string will not be valid source primarily in the case | 543 * source. The returned string will not be valid source primarily in the case |
(...skipping 6499 matching lines...) Expand 10 before | Expand all | Expand 10 after Loading... |
7044 /** | 7043 /** |
7045 * Return the 'yield' keyword. | 7044 * Return the 'yield' keyword. |
7046 */ | 7045 */ |
7047 Token get yieldKeyword; | 7046 Token get yieldKeyword; |
7048 | 7047 |
7049 /** | 7048 /** |
7050 * Return the 'yield' keyword to the given [token]. | 7049 * Return the 'yield' keyword to the given [token]. |
7051 */ | 7050 */ |
7052 void set yieldKeyword(Token token); | 7051 void set yieldKeyword(Token token); |
7053 } | 7052 } |
OLD | NEW |