Dart 命名可选参数

命名可选参数为函数调用提供了更大的灵活性。它们允许你在调用函数时，仅传递所需的参数，并且这些参数可以按照任意顺序传递。

使用命名可选参数

定义带有命名可选参数的函数

你可以通过在参数前面加上{}来定义命名可选参数。例如：

void printPersonInfo({String? name, int? age}) {
  print('Name: $name');
  print('Age: $age');
}

在这个例子中，printPersonInfo 函数有两个命名可选参数：name 和 age。这两个参数都可以设置为可选的，因为它们使用了空值安全的?操作符。

调用带有命名可选参数的函数

当你调用带有命名可选参数的函数时，你可以选择传递或不传递这些参数。如果你传递了这些参数，你可以按照任何顺序传递它们。例如：

// www.javascriptcn.com code example
printPersonInfo(name: 'Alice', age: 30);
// 输出：
// Name: Alice
// Age: 30

printPersonInfo(age: 40, name: 'Bob');
// 输出：
// Name: Bob
// Age: 40

如果未提供这些参数，那么对应的变量将保持为它们的默认值，即null：

printPersonInfo();
// 输出：
// Name: null
// Age: null

设置默认值

你可以为命名可选参数设置默认值，以便在未提供参数时使用这些默认值。例如：

// www.javascriptcn.com code example
void printPersonInfo({String? name = 'Unknown', int? age = 0}) {
  print('Name: $name');
  print('Age: $age');
}

printPersonInfo();
// 输出：
// Name: Unknown
// Age: 0

混合使用命名可选参数和位置参数

在同一个函数签名中，你可以混合使用命名可选参数和位置参数。但是，一旦你开始使用命名参数，所有随后的参数都必须是命名参数。例如：

// www.javascriptcn.com code example
void printDetails(String title, {int? id, String? description}) {
  print('Title: $title');
  print('ID: $id');
  print('Description: $description');
}

printDetails('Introduction', id: 1, description: 'This is the first section.');
// 输出：
// Title: Introduction
// ID: 1
// Description: This is the first section.

printDetails('Conclusion', description: 'This is the last section.');
// 输出：
// Title: Conclusion
// ID: null
// Description: This is the last section.

在这个例子中，title是一个位置参数，而id和description都是命名可选参数。由于id和description是命名参数，所以它们可以在调用时以任意顺序传递。

命名可选参数的优势

• 代码可读性：通过使用命名参数，你可以明确地知道每个参数代表什么，这使得代码更易于阅读。
• 灵活性：你可以根据需要选择传递哪些参数，而不必担心参数的位置。
• 默认值：你可以为参数设置默认值，使得函数调用更加灵活。

总结

命名可选参数为 Dart 提供了一种强大的方式来处理函数参数，使你的代码更加清晰、灵活和易于维护。在编写具有复杂参数列表的函数时，命名可选参数尤其有用。