Dart函数

---

Dart 是真正的面向对象的语言 函数都是对象 且是具有类型函数
这意味着可以将函数分配给变量或作为参数传递给其他函数
也可以将Dart类的实例称为函数

详细信息参见可调用类(Callable classes)
//dart.dev/guides/language/language-tour#callable-classes
实现函数示例
bool isNoble(int atomicNumber) {
  return _nobleGases[atomicNumber] != null;
}
// 当然 也可以不写函数的定义
isNoble(int atomicNumber) {
  return _nobleGases[atomicNumber] != null;
}
对于仅有一个表达式的函数 可使用缩写语法
bool isNoble(int atomicNumber) => _nobleGases[atomicNumber] != null;
=> expr 是 { return expr; } 形式的缩写 我们也称之为箭头语法

可选参数
可选参数可以是 命名参数 或 位置参数 但不能同时选择

命名参数
调用函数时  可以使用 paramName:value 来指定命名参数
例如：enableFlags(bold: true, hidden: false);

尽管命名参数是一种可选参数
但是可以使用 @required 对其进行标注 以声明该参数是强制性的 必须为该参数提供一个值
例如const Scrollbar({Key key, @required Widget child})

当创建滚动条而不指定子参数时 则分析器将报告错误
需要使用 @required 进行标注 取决于 meta package 且导入 package:meta/meta.dart

位置参数
在参数装在 中括号[] 中就表示该参数是位置参数
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');
默认参数值
函数可以使用 赋值号 = 来定义命名参数和位置参数的默认值 如果未提供默认值 则默认值为 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');
}

---

主函数
每个应用程序都必须含有顶级 main() 函数
该函数充当该应用程序的入口
main() 函数返回 void
并具有可选的 List <String> 参数作为 main() 函数的参数
一个 web 应用程序中的 main() 函数示例
void main() {
querySelector('#sample_text_id')
    ..text = 'Click me!'
    ..onClick.listen(reverseText);
}
带有参数的命令行应用程序的 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');
}
使用 args library 来定义和解析命令行参数
https://pub.dev/packages/args

---

第一类对象
可以将一个函数作为参数传递给另一个函数
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 !!!');

---

匿名函数
大多数的函数是已经命名好的
例如 main() 或 printElement()
还可以创建一个没有名称的函数 称之为 匿名函数
有时也可以创建一个 lambda 或 闭包
可以将匿名函数分配给变量
更方便操作
匿名函数看起来类似于命名函数 示例
([[Type] param1[, …]]) {
  codeBlock;
};
为一个匿名函数 该匿名函数传入了个参数 item 为列表中的每个子项调用的函数将打印一个字符串 其中包括指定索引处的值
void main() {
  var list = ['apples', 'bananas', 'oranges'];
  list.forEach((item) {
    print('${list.indexOf(item)}: $item');
  });
}
如果该函数仅包含一个语句 则可以使用箭头符号将其缩短
void main() {
  var list = ['apples', 'bananas', 'oranges'];
  list.forEach(   (item) => print('${list.indexOf(item)}: $item'));
}

---

词法范围
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);
    }
  }
}

---

语法闭包
闭包是可以在其语法范围内访问变量的函数对象 即使该函数在其原始范围之外使用也是如此
闭包可以在其范围中自定义变量 在以下示例中 makeAdder() 捕获变量 addBy
无论返回的函数到哪里 它都会记住 addBy
/// 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);
}

---

检查是否相等的测试函数
这是测试顶级函数 静态方法和实例方法是否相等示例
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);
}
返回值
所有函数都返回一个值
如果未定义返回值则返回 null
这是 Dart 语言隐式的添加到了函数体里
foo() {}
assert(foo() == null);