Dart 是一种真正的面向对象语言,因此即使是函数也是对象并且具有类型 Function。这意味着函数可以分配给变量或作为参数传递给其他函数。您还可以像调用函数一样调用 Dart 类的实例。有关详细信息,请参阅可调用对象。
下面是一个实现函数的例子:
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 小部件构造函数)仅使用命名参数,即使对于强制参数也是如此。有关详细信息,请参阅下一节。
当您将参数传递给函数或定义函数参数时,可以使用尾随逗号。
命名参数
命名参数是可选的,除非它们被明确标记为 required 。
定义函数时,使用 {param1, param2, …} 指定命名参数。如果您不提供默认值或将命名参数标记为 required ,则它们的类型必须可为 null,因为它们的默认值将为 null :
/// Sets the [bold] and [hidden] flags ...
void enableFlags({bool? bold, bool? hidden}) {...}
调用函数时,您可以使用 paramName: value 指定命名参数。例如:
enableFlags(bold: true, hidden: false);
要为 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);
如果您希望命名参数是强制性的,要求调用者提供参数的值,请使用 required 对其进行注释:
const Scrollbar({super.key, required Widget child});
如果有人尝试创建 Scrollbar 而不指定 child 参数,则分析器会报告问题。 标记为 required 的参数仍然可以为空:
const Scrollbar({super.key, required Widget? child});
您可能想首先放置位置参数,但 Dart 不需要它。当适合您的 API 时,Dart 允许将命名参数放置在参数列表中的任何位置:
repeat(times: 2, () {
...
});
可选位置参数
将一组函数参数包装在 [] 中将它们标记为可选位置参数。如果您不提供默认值,则它们的类型必须可为空,因为它们的默认值为 null :
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');
要为 null 之外的可选位置参数定义默认值,请使用 = 指定默认值。指定的值必须是编译时常量。例如:
String say(String from, String msg, [String device = 'carrier pigeon']) {
var result = '$from says $msg with a $device';
return result;
}
assert(say('Bob', 'Howdy') == 'Bob says Howdy with a carrier pigeon');
main() 函数
每个应用程序都必须有一个顶级 main() 函数,作为应用程序的入口点。 main() 函数返回 void 并具有可选的 List
void main() {
print('Hello, World!');
}
以下是带有参数的命令行应用程序的 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 库来定义和解析命令行参数
作为一流对象的功能
您可以将一个函数作为参数传递给另一个函数。例如:
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 的匿名函数,并将其传递给 map 函数。为列表中的每个项目调用该函数,将每个字符串转换为大写。然后在传递给 forEach 的匿名函数中,每个转换后的字符串都会与其长度一起打印出来。
const list = ['apples', 'bananas', 'oranges'];
list.map((item) {
return item.toUpperCase();
}).forEach((item) {
print('$item: ${item.length}');
});
void main() {
const list = ['apples', 'bananas', 'oranges'];
list.map((item) {
return item.toUpperCase();
}).forEach((item) {
print('$item: ${item.length}');
});
}
如果函数仅包含单个表达式或返回语句,您可以使用箭头表示法缩短它。将以下行粘贴到 DartPad 中,然后单击“运行”以验证其功能是否等效。
list
.map((item) => item.toUpperCase())
.forEach((item) => print('$item: ${item.length}'));
词汇范围
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(int addBy) {
return (int 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() {
Function 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 null; 会隐式附加到函数体中。
foo() {}
assert(foo() == null);
要在函数中返回多个值,请聚合记录中的值。
(String, int) foo() {
return ('something', 42);
}
发电机
当您需要延迟生成值序列时,请考虑使用生成器函数。 Dart 内置支持两种生成器函数:
- 同步生成器:返回一个 Iterable 对象。
- 异步生成器:返回一个 Stream 对象。
要实现同步生成器函数,请将函数体标记为 sync* ,并使用 yield 语句传递值:
Iterable<int> naturalsTo(int n) sync* {
int k = 0;
while (k < n) yield k++;
}
要实现异步生成器函数,请将函数体标记为 async* ,并使用 yield 语句传递值:
Stream<int> asynchronousNaturalsTo(int n) async* {
int k = 0;
while (k < n) yield k++;
}
如果您的生成器是递归的,您可以使用 yield* 提高其性能:
Iterable<int> naturalsDownFrom(int n) sync* {
if (n > 0) {
yield n;
yield* naturalsDownFrom(n - 1);
}
}