(三)Dart Functions（方法）

Dart方法概述

Dart 是一个真正的面向对象语言，方法也是对象并且具有一种 类型， Function。 这意味着，方法可以赋值给变量，也可以当做其他方法的参数。 也可以把 Dart 类的实例当做方法来调用。 详情请参考 Callable classes。

一、方法定义

1.1.一般的方法定义：

返回值类型 方法名(参数类型 参数名n, 参数类型 参数名n+1) {
return 返回值;
}

  int sum(int a, int b) {
    return a + b;
  }

1.2.忽略类型定义(建议在公开的 APIs 上使用静态类型)

方法名( 参数名n, 参数名n+1) {
return 返回值;
}

    sum(a, b) {
    return a + b;
  }

1.3.只有一个表达式的方法，你可以选择使用缩写语法(有时也叫胖箭头语法)来定义：

返回值类型 方法名(参数类型 参数名n, 参数类型 参数名n+1) => a + b;

int sum(int a, int b) => a + b;

注意：
1、箭头 (=>) 和分号 (;) 之间只能使用一个表达式 ,不能使用 语句。
2、对于 void 类型的成员则 不是 一种期望的使用场景。 读者期望 => 返回一个有用的值，所以对于没有返回值的情况，还是使用 { ... } 使代码更加清晰。

二、方法参数

方法可以有两种类型的参数：必需的和可选的。 必需的参数在参数列表前面， 后面是可选参数。

2.1.Optional parameters（可选参数）

可选参数可以是命名参数或者基于位置的参数，但是这两种参数不能同时当做可选参数。

在定义方法的时候，使用 {param1, param2, …} 的形式来指定命名参数：

/// Sets the [bold] and [hidden] flags to the values
/// you specify.
enableFlags({bool bold, bool hidden}) {
  // ...
}

调用方法的时候，你可以使用这种形式 paramName: value 来指定命名参数。例如：

enableFlags(bold: true, hidden: false);

2.2.Optional positional parameters（可选位置参数）

把一些方法的参数放到 [] 中就变成可选 位置参数了：

String say(String from, String msg, [String device]) {
  var result = '$from says $msg';
  if (device != null) {
    result = '$result with a $device';
  }
  return result;
}
// 下面是不使用可选参数调用上面方法 的示例：
assert(say('Bob', 'Howdy') == 'Bob says Howdy');
// 下面是使用可选参数调用上面方法的示例：
assert(say('Bob', 'Howdy', 'smoke signal') ==
    'Bob says Howdy with a smoke signal');

2.3.Default parameter values（默认参数值）

在定义方法的时候，可以使用 = 来定义可选参数的默认值。 默认值只能是编译时常量。 如果没有提供默认值，则默认值为 null。

/// Sets the [bold] and [hidden] flags to the values you
/// specify, defaulting to false.
void enableFlags({bool bold = false, bool hidden = false}) {
  // ...
}

// bold will be true; hidden will be false.
enableFlags(bold: true);

版本问题： 旧版本代码可能需要使用一个冒号 (:) 而不是 = 来设置参数默认值。 原因在于 Dart SDK 1.21 之前的版本，命名参数只支持 :。 : 设置命名默认参数值在以后版本中将不能使用， 所以我们推荐你 使用 = 来设置默认值， 并 指定 Dart SDK 版本为 1.21 或者更高的版本。

下面的示例显示了如何设置位置参数的默认值：

String say(String from, String msg,
    [String device = 'carrier pigeon', String mood]) {
  var result = '$from says $msg';
  if (device != null) {
    result = '$result with a $device';
  }
  if (mood != null) {
    result = '$result (in a $mood mood)';
  }
  return result;
}

assert(say('Bob', 'Howdy') ==
    'Bob says Howdy with a carrier pigeon');

还可以使用 list 或者 map 作为默认值。 下面的示例定义了一个方法 doStuff()， 并分别为 list 和 gifts 参数指定了 默认值。

void doStuff(
    {List<int> list = const [1, 2, 3],
    Map<String, String> gifts = const {
      'first': 'paper',
      'second': 'cotton',
      'third': 'leather'
    }}) {
  print('list:  $list');
  print('gifts: $gifts');
}

三、The main() function（入口函数）

每个应用都需要有个顶级的 main() 入口方法才能执行。 main() 方法的返回值为 void 并且有个可选的 List<String> 参数。

下面是一个 web 应用的 main() 方法：

void main() {
  querySelector("#sample_text_id")
    ..text = "Click me!"
    ..onClick.listen(reverseText);
}

注意： 前面代码中的 .. 语法为 级联调用（cascade）。 使用级联调用语法， 你可以在一个对象上执行多个操作。现在了解就行，会在下一篇的Dart操作符详细介绍。

下面是一个命令行应用的 main() 方法，并且使用了 方法参数作为输入参数：

// Run the app like this: dart args.dart 1 test
void main(List<String> arguments) {
  print(arguments);

  assert(arguments.length == 2);
  assert(int.parse(arguments[0]) == 1);
  assert(arguments[1] == 'test');
}

四、Functions as first-class objects（一等方法对象）

• 可以把方法当做参数调用另外一个方法。

printElement(element) {
  print(element);
}

var list = [1, 2, 3];

// Pass printElement as a parameter.
list.forEach(printElement);

• 方法也可以赋值给一个变量。

var loudify = (msg) => '!!! ${msg.toUpperCase()} !!!'; // 匿名方法
assert(loudify('hello') == '!!! HELLO !!!');

五、Anonymous functions（匿名方法）

大部分方法都带有名字，例如 main() 或者 printElement()。 你有可以创建没有名字的方法，称之为 匿名方法，有时候也被称为 lambda 或者 closure 闭包。 你可以把匿名方法赋值给一个变量， 然后你可以使用这个方法，比如添加到集合或者从集合中删除。

匿名函数和命名函数看起来类似—— 在括号之间可以定义一些参数，参数使用逗号 分割，也可以是可选参数。 后面大括号中的代码为函数体：

([[Type] param1[, …]]) {
codeBlock;
};

下面的代码定义了一个参数为i （该参数没有指定类型）的匿名函数。 list 中的每个元素都会调用这个函数来 打印出来，同时来计算了每个元素在 list 中的索引位置。

var list = ['apples', 'oranges', 'grapes', 'bananas', 'plums'];
list.forEach((i) {
  print(list.indexOf(i).toString() + ': ' + i);
});

// 或者使用胖箭头语法缩写
list.forEach((i) => print(list.indexOf(i).toString() + ': ' + i));

六、Lexical scope（静态作用域）

Dart 是静态作用域语言，变量的作用域在写代码的时候就确定过了。 基本上大括号里面定义的变量就 只能在大括号里面访问，和 Java 作用域 类似。

var topLevel = true;

main() {
  var insideMain = true;

  myFunction() {
    var insideFunction = true;

    nestedFunction() {
      var insideNestedFunction = true;

      assert(topLevel);
      assert(insideMain);
      assert(insideFunction);
      assert(insideNestedFunction);
    }
  }
}

注意 nestedFunction() 可以访问所有的变量， 包含顶级变量。

七、Lexical closures（语法闭包）

一个 闭包 是一个方法对象，不管该对象在何处被调用， 该对象都可以访问其作用域内 的变量。

方法可以封闭定义到其作用域内的变量。 下面的示例中，makeAdder() 捕获到了变量 addBy。 不管你在那里执行 makeAdder() 所返回的函数，都可以使用 addBy 参数。

/// Returns a function that adds [addBy] to the
/// function's argument.
Function makeAdder(num addBy) {
  return (num i) => addBy + i;
}

main() {
  // Create a function that adds 2.
  var add2 = makeAdder(2);

  // Create a function that adds 4.
  var add4 = makeAdder(4);

  assert(add2(3) == 5);
  assert(add4(3) == 7);
}

八、Testing functions for equality（测试函数是否相等）

下面是测试顶级方法、静态函数和实例函数 相等的示例：

void foo() {} // 顶级方法

class A {
  static void bar() {} // 静态函数
  void baz() {} // 实例函数
}

void main() {
  var x;

  // 对比顶级方法
  x = foo;
  assert(foo == x);

  // 对比静态函数
  x = A.bar;
  assert(A.bar == x);

  // 对比实例函数
  var v = A(); // Instance #1 of A
  var w = A(); // Instance #2 of A
  var y = w;
  x = w.baz;

  // 这些闭包指向同一实例 (#2),
  // 因此他们是相等的
  assert(y.baz == x);

  // 这些闭包指向不同的实例
  // 因此他们不是相等的
  assert(v.baz != w.baz);
}

九、Return values（返回值）

所有的函数都返回一个值。如果没有指定返回值，则 默认把语句 return null; 作为函数的最后一个语句执行。

十、变量及方法作用域

Dart 没有public ，protected，and private的概念。

但是如果变量或函数以下划线(_)开始，则该函数或变量属于这个包私有(private)的方法。