OLD | NEW |
1 // Copyright (c) 2011, the Dart project authors. Please see the AUTHORS file | 1 // Copyright (c) 2011, 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 part of dart.core; | 5 part of dart.core; |
6 | 6 |
7 /** | 7 /** |
8 * The base class for all function types. | 8 * The base class for all function types. |
9 * | 9 * |
10 * A function value, or an instance of a class with a "call" method, is a | 10 * A function value, or an instance of a class with a "call" method, is a |
11 * subtype of a function type, and as such, a subtype of [Function]. | 11 * subtype of a function type, and as such, a subtype of [Function]. |
12 */ | 12 */ |
13 abstract class Function { | 13 abstract class Function { |
14 /** | 14 /** |
15 * Dynamically call [function] with the specified arguments. | 15 * Dynamically call [function] with the specified arguments. |
16 * | 16 * |
17 * Acts the same as calling function with positional arguments | 17 * Acts the same as calling function with positional arguments |
18 * corresponding to the elements of [positionalArguments] and | 18 * corresponding to the elements of [positionalArguments] and |
19 * named arguments corresponding to the elements of [namedArguments]. | 19 * named arguments corresponding to the elements of [namedArguments]. |
20 * | 20 * |
21 * This includes giving the same errors if [function] isn't callable or | 21 * This includes giving the same errors if [function] isn't callable or |
22 * if it expects different parameters. | 22 * if it expects different parameters. |
23 * | 23 * |
24 * Example: [: | 24 * Example: |
25 * Map<Symbol, dynamic> namedArguments = new Map<Symbol, dynamic>(); | 25 * Map<Symbol, dynamic> namedArguments = new Map<Symbol, dynamic>(); |
26 * namedArguments[const Symbol("f")] = 4; | 26 * namedArguments[const Symbol("f")] = 4; |
27 * namedArguments[const Symbol("g")] = 5; | 27 * namedArguments[const Symbol("g")] = 5; |
28 * Function.apply(foo, [1,2,3], namedArguments); :] | 28 * Function.apply(foo, [1,2,3], namedArguments); |
29 * gives exactly the same result as [: foo(1, 2, 3, f: 4, g: 5) :]. | 29 * |
| 30 * gives exactly the same result as |
| 31 * foo(1, 2, 3, f: 4, g: 5). |
30 * | 32 * |
31 * If [positionalArguments] is null, it's considered an empty list. | 33 * If [positionalArguments] is null, it's considered an empty list. |
32 * If [namedArguments] is omitted or null, it is considered an empty map. | 34 * If [namedArguments] is omitted or null, it is considered an empty map. |
33 */ | 35 */ |
34 external static apply(Function function, | 36 external static apply(Function function, |
35 List positionalArguments, | 37 List positionalArguments, |
36 [Map<Symbol, dynamic> namedArguments]); | 38 [Map<Symbol, dynamic> namedArguments]); |
37 } | 39 } |
OLD | NEW |