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 // Dart core library. |
6 | 6 |
7 /** | 7 /** |
8 * Super-type of all function types. | 8 * Super-type of 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: [: Function.apply(foo, [1,2,3], {"f": 4, "g": 5}) :] gives | 24 * Example: [: Function.apply(foo, [1,2,3], {"f": 4, "g": 5}) :] gives |
25 * exactly the same result as [: foo(1, 2, 3, f: 4, g: 5) :]. | 25 * exactly the same result as [: foo(1, 2, 3, f: 4, g: 5) :]. |
26 * | 26 * |
27 * If [positionalArguments] is null, it's considered an empty list. | 27 * If [positionalArguments] is null, it's considered an empty list. |
28 * If [namedArguments] is omitted or null, it is considered an empty map. | 28 * If [namedArguments] is omitted or null, it is considered an empty map. |
29 */ | 29 */ |
30 external static apply(Function function, | 30 external static apply(Function function, |
31 List positionalArguments, | 31 List positionalArguments, |
32 [Map<String,dynamic> namedArguments]); | 32 [Map<String,dynamic> namedArguments]); |
33 } | 33 } |
OLD | NEW |