Dart 简明教程 - 02 - FunctionsDart 是面向对象的语言，即使是函数也是对象，类型是 Functi

本系列教程大多翻译自 Dart 官网，因本人英语水平有限，可能有些地方翻译不准确，还请各位大佬斧正。如需转载请标明出处，谢绝 CSDN 爬虫党。

Functions

Dart 是面向对象的语言，即使是函数也是对象，类型是 Function。这意味着函数可以赋值给变量，或者当做参数传入其他函数。你也可以认为函数相当于 Dart 中的类。

bool isNoble(int atomicNumber) {
  return _nobleGases[atomicNumber] != null;
}

Dart 推荐编写 API 的时候带上类型，当然，如果你忽略了也能运行。

isNoble(atomicNumber) {
  return _nobleGases[atomicNumber] != null;
}

和 JavaScript 一样，Dart 支持箭头函数：

bool isNoble(int atomicNumber) => _nobleGases[atomicNumber] != null;

箭头 => expr 相当于 { return expr;}

只有表达式，而不是条件式，才可以在 => 和 ; 之间，比如，不能使用 if (),但是可以使用三目运算符

函数有两种类型的参数，[必传参数]和[可选参数]。必传参数必须在参数列表前面，后面可以跟任意的可选参数。

可选参数（Optional parameters）

可选参数可以是[具名参数]或者[位置参数]，但不能同时是两者。

Note: 一些 API, 尤其是 Flutter 的组件构造器，只支持[具名参数]，即使参数是强制的。

具名参数（Named parameters）

当调用函数时，你可以这样命名参数: paramName: value，如：

enableFlags(bold: true, hidden: false);

定义函数时，使用{param1, param2, …}的方式命名参数：

/// Sets the [bold] and [hidden] flags ...
void enableFlags({bool bold, bool hidden}) {...}

虽然具名参数是可选参数，你也可以使用 @required去描述这个参数是必须传入的。

const Scrollbar({Key key, @required Widget child})
// 如果 Scrollbar 没有传齐参数，编译器会报告问题

使用 @required 修饰符，要先引入 meta 包: package: meta/meta.dart

位置参数（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');

默认参数（Default parameter values）

和 JavaScript 一样，使用 = 来给参数设置默认值，默认值必须是编译常量。如果没有设置默认值，那么参数的默认值就是 null。

给具名参数设置默认值：

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

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

老代码里可能会使用冒号(:)替代 = 来设置具名参数的默认值。说来话长，当时设计的是只有具名参数支持 :。将来会取消这个写法，因此推荐使用 = 来设置默认值。

给位置参数设置默认值：

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 来最为默认值：

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）

所有的 app 都必须有个顶级函数 main() 作为应用的入口。main() 函数返回 void类型，并且参数列表为 List<String> 类型的可选参数。

比如：

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

Note: ..语法类似于 JavaScript 的链式调用，即可以在一个对象上进行多次操作。

使用 List<String> 的例子

// 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');
}

你也可以使用 args library 来定义和解析[命令行数组](command-line arguments)

函数是一级对象（Functions as first-class objects）

你可以把函数当参数传入另一个函数：

void printElement(int 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 函数或者闭包。你可以把匿名函数赋值给变量。

匿名函数和具名函数相似：有0个或多个参数，使用圆括号()包裹起来，通过逗号,分隔参数，也有可选参数和参数修饰符。

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

下面是一个使用匿名函数的例子，参数是未指定类型的item。这是一个通过遍历 list 来查找 item 在 list 中的下标的函数。

var list = ['apples', 'bananas', 'oranges'];
list.forEach((item) {
  print('${list.indexOf(item)}: $item');
});

更简洁的写法：

list.forEach((item) => print('${list.indexOf(item)}: $item'));

词法作用域（Lexical scope）

和 JavaScript 一样，Dart 的变量拥有作用域。分为全局作用域和块级(函数)作用域。

块级作用域可以访问上一层的作用域，直至全局作用域

bool topLevel = true;

void main() {
  var insideMain = true;

  void myFunction() {
    var insideFunction = true;

    void nestedFunction() {
      var insideNestedFunction = true;

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

闭包（Lexical closures）

当一个函数作为另一个函数的返回值时，就形成了闭包。闭包作用域在外部依然生效（相当于里面的变量被缓存了）。

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

void 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() {} // A top-level function

class A {
  static void bar() {} // A static method
  void baz() {} // An instance method
}

void main() {
  var x;

  // Comparing top-level functions.
  x = foo;
  assert(foo == x);

  // Comparing static methods.
  x = A.bar;
  assert(A.bar == x);

  // Comparing instance methods.
  var v = A(); // Instance #1 of A
  var w = A(); // Instance #2 of A
  var y = w;
  x = w.baz;

  // These closures refer to the same instance (#2),
  // so they're equal.
  assert(y.baz == x);

  // These closures refer to different instances,
  // so they're unequal.
  assert(v.baz != w.baz);
}

返回值（Return values）

所有的函数都有返回值，如果没写返回值，会默认添加 return null，例如：

foo() {}
assert(foo() == null);

系列文章：

Dart 简明教程 - 01 - Concepts & Variables
Dart 简明教程 - 02 - Functions
Dart 简明教程 - 03 - Operators
Dart 简明教程 - 04 - Control flow statements
Dart 简明教程 - 05 - Exceptions
Dart 简明教程 - 06 - Classes
Dart 简明教程 - 07 - Generics
Dart 简明教程 - 08 - Libraries and visibility
Dart 简明教程 - 09 - Asynchrony support
Dart 简明教程 - 10 - Generators & Isolates & Typedefs & Metadata...

Dart 简明教程 - 02 - Functions