Implement ObjectMirror.[]

sdk/lib/mirrors/mirrors.dart

 // Copyright (c) 2012, the Dart project authors.  Please see the AUTHORS file
 // for details. All rights reserved. Use of this source code is governed by a
 // BSD-style license that can be found in the LICENSE file.
 
 // For the purposes of the mirrors library, we adopt a naming
 // convention with respect to getters and setters.  Specifically, for
 // some variable or field...
 //
 //   var myField;
 //
@@ skipping 529 matching lines @@
 
   /**
    * Perform [invocation] on [reflectee].
    * Equivalent to
    *
    * this.invoke(invocation.memberName,
    *             invocation.positionalArguments,
    *             invocation.namedArguments);
    */
   delegate(Invocation invocation);
+
+  /**
+   * Returns a closure for invoking the regular method named [name].
+   *
+   * If [:type.instanceLookup(name):] returns a regular method, the result of
+   * this method is a closure equivalent to:
+   *
+   *     (r1, .., rn, {p1: d1, ..., pk: dk}) {
+   *       return this.invoke(name, [r1, .., rn], {#p1: p1,  .., #pk: pk});
+   *     }
+   *
+   * if m has required parameters r1, ..., rn, and named parameters p1, ..., pk
+   * with defaults d1, ..., dk.
+   *
+   *     (r1, .., rn, [p1 = d1, …, pk = dk]) {
+   *       return this.invoke(name, [r1, .., rn, p1, .., pk]);
+   *     }
+   *
+   * if m has required parameters r1, ..., rn, and optional positional
+   * parameters p1, ..., pk with defaults d1, ..., dk.
+   */

[gbracha, 2013/10/03 00:58:54]

See proposed modification to wording below.  Applies to all 3 versions.

[rmacnak, 2013/10/03 16:58:07]

Done.

+  Function operator [](Symbol name);
+
 }
 
 /**
  * A [ClosureMirror] reflects a closure.
  *
  * A [ClosureMirror] provides access to its captured variables and
  * provides the ability to execute its reflectee.
  */
 abstract class ClosureMirror implements InstanceMirror {
   /**
@@ skipping 125 matching lines @@
    *
    * The equality holds if and only if
    * (1) [other] is a mirror of the same kind
    * and
    * (2)  The library being reflected by this mirror
    * and the library being reflected by [other]
    * are
    * the same library in the same isolate.
    */
    bool operator == (other);
+
+  /**
+   * If [:declarations[name]:] is a regular method, the result of this method
+   * is a closure equivalent to:
+   *
+   *     (r1, .., rn, {p1: d1, ..., pk: dk}) {
+   *       return this.invoke(name, [r1, .., rn], {#p1: p1,  .., #pk: pk});
+   *     }
+   *
+   * if m has required parameters r1, ..., rn, and named parameters p1, ..., pk
+   * with defaults d1, ..., dk.
+   *
+   *     (r1, .., rn, [p1 = d1, …, pk = dk]) {
+   *       return this.invoke(name, [r1, .., rn, p1, .., pk]);
+   *     }
+   *
+   * if m has required parameters r1, ..., rn, and optional positional
+   * parameters p1, ..., pk with defaults d1, ..., dk.
+   */
+  Function operator [](Symbol name);
 }
 
 /**
  * A [TypeMirror] reflects a Dart language class, typedef,
  * or type variable.
  */
 abstract class TypeMirror implements DeclarationMirror {
 }
 
 /**
@@ skipping 193 matching lines @@
    * The equality holds if and only if
    * (1) [other] is a mirror of the same kind
    * and
    * (2) This mirror and [other] reflect the same class.
    *
    * Note that if the reflected class is an invocation of
    * a generic class,(2) implies that the reflected class
    * and [other] have equal type arguments.
    */
    bool operator == (other);
+
+  /**
+   * If [:declarations[name]:] is a regular method, the result of this method
+   * is a closure equivalent to:
+   *
+   *     (r1, .., rn, {p1: d1, ..., pk: dk}) {
+   *       return this.invoke(name, [r1, .., rn], {#p1: p1,  .., #pk: pk});
+   *     }
+   *
+   * if m has required parameters r1, ..., rn, and named parameters p1, ..., pk
+   * with defaults d1, ..., dk.

[gbracha, 2013/10/03 00:58:54]

Otherwise, the result of this method is a closure equivalent to:

+   *
+   *     (r1, .., rn, [p1 = d1, …, pk = dk]) {
+   *       return this.invoke(name, [r1, .., rn, p1, .., pk]);
+   *     }
+   *
+   * if m has required parameters r1, ..., rn, and optional positional
+   * parameters p1, ..., pk with defaults d1, ..., dk.
+   */
+  Function operator [](Symbol name);
 }
 
 /**
  * A [FunctionTypeMirror] represents the type of a function in the
  * Dart language.
  */
 abstract class FunctionTypeMirror implements ClassMirror {
   /**
    * Returns the return type of the reflectee.
    */
@@ skipping 429 matching lines @@
    *
    * When used as metadata on an import of "dart:mirrors", this metadata does
    * not apply to the library in which the annotation is used, but instead
    * applies to the other libraries (all libraries if "*" is used).
    */
   final override;
 
   const MirrorsUsed(
       {this.symbols, this.targets, this.metaTargets, this.override});
 }