Dart 是一个真正的面向对象语言,方法也是对象并且具有一种 类型, Function。 这意味着,方法可以赋值给变量,也可以当做其他方法的参数。 也可以把 Dart 类的实例当做方法来调用。 详情请参考 Callable classes。
下面是定义方法的示例:
bool isNoble(int atomicNumber) { return _nobleGases[atomicNumber] != null; }
虽然在 Effective Dart 中推荐 在公开的 APIs 上使用静态类型, 你当然也可以选择忽略类型定义:
isNoble(atomicNumber) { return _nobleGases[atomicNumber] != null; }
对于只有一个表达式的方法,你可以选择 使用缩写语法来定义:
bool isNoble(int atomicNumber) => _nobleGases[atomicNumber] != null;
这个 => expr 语法是 { return expr; } 形式的缩写。 => 形式 有时候也称之为 胖箭头 语法。
注意: 在箭头 (=>) 和冒号 (;) 之间只能使用一个 表达式 – 不能使用 语句。 例如:你不能使用 if statement,但是可以 使用条件表达式 conditional expression。
方法可以有两种类型的参数:必需的和可选的。 必需的参数在参数列表前面, 后面是可选参数。
Optional parameters(可选参数)
可选参数可以是命名参数或者基于位置的参数,但是这两种参数不能同时当做可选参数。
Optional named parameters(可选命名参数)
调用方法的时候,你可以使用这种形式 paramName: value 来指定命名参数。例如:
enableFlags(bold: true, hidden: false);
在定义方法的时候,使用 {param1, param2, …} 的形式来指定命名参数:
/// Sets the [bold] and [hidden] flags to the values /// you specify. enableFlags({bool bold, bool hidden}) { // ... }
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');
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 参数。
下面是一个 web 应用的 main() 方法:
void main() { querySelector("#sample_text_id") ..text = "Click me!" ..onClick.listen(reverseText); }
注意: 前面代码中的 .. 语法为 级联调用(cascade)。 使用级联调用语法, 你可以在一个对象上执行多个操作。
下面是一个命令行应用的 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 来 定义和解析命令行输入的参数数据。
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); });
如果方法只包含一个语句,可以使用胖箭头语法缩写。 把下面的代码粘贴到 DartPad 中运行,可以看到结果是一样的。
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(测试函数是否相等)
下面是测试顶级方法、静态函数和实例函数 相等的示例:
foo() {} // A top-level function class A { static void bar() {} // A static method void baz() {} // An instance method } 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 = new A(); // Instance #1 of A var w = new 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; 作为函数的最后一个语句执行。