Dart基础之定义函数

Dart是一个真-面向对象语言，因此甚至连 functions 都是objects，而且有一个类型叫 Function。 这表示functons能够被变量指定或者以参数的方式传递给其余functions。若是Dart类型实例是一个function的话你也能够直接调用。

Demo:

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

虽然Effective Dart建议为公共API注释类型，但若是省略类型，该函数仍然有效：

isNoble(atomicNumber) {
  return _nobleGases[atomicNumber] != null;
}
复制代码

对于只包含一个表达式的函数，可使用简写语法：

bool isNoble(int atomicNumber) => _nobleGases[atomicNumber] != null;
复制代码

=> expr 标志是 { return expr; }的缩写，=>表示法有时称为箭头语法。

注意：箭头（=>）和分号（;）之间只能出现表达式而非语句。 例如，您不能在其中放置if语句，但可使用条件表达式。

函数能够有两种类型的参数：必需和可选。 首先列出所需参数，而后列出任何可选参数。 可选参数能够是命名的或位置的。

注意：某些API（特别是Flutter widget构造函数）仅命名参数，即便对于必需参数也是如此。

(可选参数)Optional parameters

可选参数能够是命名参数，也能够是位置参数，但不能同时知足

(命名参数)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而未指定child的参数，解析器就会报错。 要使用@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');
复制代码

参数默认数值

在function 中用 = 来定义参数默认值，命名参数和位置参数同时适用。 默认值必须是编译时常量，若是没有提供默认值，默认是 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');
复制代码

你也能够传递 lists 或者 maps 做为默认值，demo以下：

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()函数

每一个app都必须有一个顶级的 main()函数做为一个app的入口服务。 main()函数返回void而且有一个可选参数List<String>。

一个 web app 的main()函数例子：

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

注意：前面代码中的..语法称为级联。 使用级联，能够对单个对象的成员们执行多个操做。

一个 command-line app 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 lib 依赖去定义和解析 command-line 参数。

Functions 做为优秀的对象

你能够把function做为一个参数传递给另一个function, 例如：

void printElement(int element) {
  print(element);
}

var list = [1, 2, 3];

// Pass printElement as a parameter.
list.forEach(printElement);
复制代码

你也能够把一个function 指定给一个变量，例如：

var loudify = (msg) => '!!! ${msg.toUpperCase()} !!!';
assert(loudify('hello') == '!!! HELLO !!!');
复制代码

这个例子用了一个匿名函数。更多关于匿名函数的知识，随后分解。

匿名函数(Anonymous functions)

大对数的函数都是有名字的，例如main()或者printElement()。固然你也能够建立没有名字的函数（匿名函数），或者有时候一个 lambda 或者 closure（闭包）。你可能把一个匿名函数赋值给一个变量，例如，你能够从一个集合中添加或者删除。 一个匿名函数跟命名函数看上去很类似 - 0个或更多的参数，由逗号分开，还有可选的类型注释, 位于括号之间。

如下的代码块包含了函数体：

([[Type] param1[, …]]) { 
  codeBlock; 
}; 
复制代码

如下示例定义一个匿名函数，使用无类型参数 item。 这个函数打印list中每一个字符串，而且输出字符串在list中的索引

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

//输出
//0: apples
//1: bananas
//2: 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);
    }
  }
}
复制代码

请注意 nestedFunction() 如何使用每一个层级的变量，一直到顶层。

词法闭包

闭包是一个函数对象，它能够访问其词法范围中的变量，即便该函数在其原始范围以外使用也是如此。

函数能够关闭周围范围中定义的变量。 在如下示例中，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隐式附加到函数体。

foo() {}

assert(foo() == null);
复制代码