Dart中的结构：Records

 Records

版本说明：记录要求语言版本至少为3.0

Records是一种匿名的、不可变的聚合类型。与其他集合类型一样，它们允许您将多个对象捆绑到单个对象中。与其他集合类型不同，Records是固定大小的、异构的和类型化的 

Records是真实的价值;您可以将它们存储在变量中，嵌套它们，将它们传递给函数或从函数传递，并将它们存储在列表、映射和集合等数据结构中。

void main(){
  var record = ('first', a: 2, b: true, 'last');
  var a = record.a;
  var b = record.b;
  var c = record.$1;
  var d = record.$2;
  print("a:${a} b:${b} c:${c} d:${d}");
  //打印结果：a:2 b:true c:first d:last
}

Records类型注释是用逗号分隔的类型列表，它们被括在圆括号中。您可以使用Records类型注释来定义返回类型和参数类型。例如，以下(int, int)语句是记录类型注释:

({int a,bool b}) temp = (a:0,b:true);

Records类型中命名字段的名称是Records类型定义或其形状的一部分。两个具有不同名称的命名字段的Records具有不同的类型:

({int a, int b}) recordAB = (a: 1, b: 2);
({int x, int y}) recordXY = (x: 3, y: 4);

// Compile error! These records don't have the same type.
// recordAB = recordXY as ({int a, int b});

在Records类型注释中，你也可以命名位置字段，但这些名称纯粹用于文档，不影响Records的类型:

(int a, int b) recordAB = (1, 2);
(int x, int y) recordXY = (3, 4);

recordAB = recordXY; // OK.
print("$recordAB");
// 打印结果：(3,4)

Record fields

Records字段可以通过内置getter访问。Records是不可变的，所以字段没有setter。
命名字段公开相同名称的getter。位置字段暴露了名称$<position>的getter，跳过了命名字段:

var record = ('first', a: 2, b: true, 'last');

print(record.$1); // Prints 'first'
print(record.a); // Prints 2
print(record.b); // Prints true
print(record.$2); // Prints 'last'

而且可以看到record的类型，内部重新进行了排序

Records中的每个字段都有自己的类型。同一Records中的字段类型可以不同。无论从Records中访问哪个字段，类型系统都知道每个字段的类型: 

(num, Object) pair = (42, 'a');

var first = pair.$1; // Static type `num`, runtime type `int`.
var second = pair.$2; // Static type `Object`, runtime type `String`.

 如果两条Records具有相同的形状(字段集)，并且它们对应的字段具有相同的值，则它们是相等的。由于命名字段的顺序不是Records形状的一部分，因此命名字段的顺序不会影响相等性

 例如：

(int x, int y, int z) point = (1, 2, 3);
(int r, int g, int b) color = (1, 2, 3);

print(point == color); // Prints 'true'.

({int x, int y, int z}) point = (x: 1, y: 2, z: 3);
({int r, int g, int b}) color = (r: 1, g: 2, b: 3);

print(point == color); // Prints 'false'. Lint: Equals on unrelated types.

Records根据字段的结构自动定义hashCode和==方法。

Multiple returns 

Records允许函数返回捆绑在一起的多个值。要从返回中检索记录值，请使用模式匹配将值解构为局部变量。 

void main(){
  // Returns multiple values in a record:
  (String, int,String) userInfo(Map<String, dynamic> json) {
    return (json['name'] as String, json['age'] as int,json['color']as String);
  }

  final json = <String, dynamic>{
    'name': 'Dash',
    'age': 10,
    'color': 'blue',
  };

// Destructures using a record pattern:
  var (name, age,color) = userInfo(json);
  print("${name} ${age} ${color}");

/* Equivalent to:
  var info = userInfo(json);
  var name = info.$1;
  var age  = info.$2;
*/
}
// 打印结果：Dash 10 blue

Records从没有记录的函数返回多个值，但其他方法有缺点。例如，创建类要冗长得多，使用其他集合类型(如List或Map)会失去类型安全性