Add apply method signature to Function class.

Add apply method signature to Function class.

This does not include an implementation for any backend. The
current implementation throws a NotImplementedException when
called.

BUG=5419
Committed: https://code.google.com/p/dart/source/detail?r=13292

[kasperl, 2012-10-05 12:51:54]

LGTM. Maybe Nicolas should take a look too?

https://codereview.chromium.org/11027059/diff/1/lib/core/function.dart
File lib/core/function.dart (right):

https://codereview.chromium.org/11027059/diff/1/lib/core/function.dart#newcode27
lib/core/function.dart:27: * if [positionalArguments] is null, it's considered
an empty list.
if -> If

[Lasse Reichstein Nielsen, 2012-10-05 12:52:58]

https://codereview.chromium.org/11027059/diff/1/lib/core/function.dart
File lib/core/function.dart (right):

https://codereview.chromium.org/11027059/diff/1/lib/core/function.dart#newcode27
lib/core/function.dart:27: * if [positionalArguments] is null, it's considered
an empty list.
On 2012/10/05 12:51:54, kasperl wrote:
> if -> If

Done.

[ngeoffray, 2012-10-05 12:57:29]

LGTM

https://codereview.chromium.org/11027059/diff/1/tests/corelib/apply_test.dart
File tests/corelib/apply_test.dart (right):

https://codereview.chromium.org/11027059/diff/1/tests/corelib/apply_test.dart...
tests/corelib/apply_test.dart:38: testMap(res, func, map) {
Looks better with named parameters:
test(res, func, {map: null, list: null})

[Lasse Reichstein Nielsen, 2012-10-08 07:52:01]

https://codereview.chromium.org/11027059/diff/1/tests/corelib/apply_test.dart
File tests/corelib/apply_test.dart (right):

https://codereview.chromium.org/11027059/diff/1/tests/corelib/apply_test.dart...
tests/corelib/apply_test.dart:38: testMap(res, func, map) {
The content of the functions differ, so having a single function with two
optional parameters would just turn it into one function with three distinct
bodies and some switching logic. That's usually a sign that it should be
separate functions.