跳到正文
教程首页
DartCH 03ch03_types_collections

ch03-types-collections

Dart 类型系统与集合:类、泛型、List/Map/Set、null 安全。完整工程共 10 个文件,其中 10 个文本源文件可在下面在线阅读。

10

在线文本文件

1,160

源码行数

dart / yaml / text

语言

17 KB

打包体积

在线阅读源码

左侧按目录浏览,点击文件切换。右上角可复制代码、复制路径或单独下载文件。在线视图只覆盖文本源码,完整工程请下载 zip。

darttextyaml

10 text files · 1,160 lines

dartlib/generics.dart
/// 泛型:Dart 的泛型是**具化(reified)**的——运行期能分辨 `List<int>` 与 `List<String>`。
///
/// 对照 Go:泛型在编译期实例化/统一形状,运行期没有类型参数;
/// 对照 C:完全没有泛型,只能靠 `void*` + 手工断言(宏能模拟一点)。
library;

/// 有界泛型:`T` 必须可比较。
T maxOf<T extends Comparable<T>>(List<T> xs) {
  if (xs.isEmpty) {
    throw ArgumentError.value(xs, 'xs', '不能为空');
  }
  var best = xs.first;
  for (final x in xs.skip(1)) {
    if (x.compareTo(best) > 0) best = x;
  }
  return best;
}

/// 泛型容器 + 泛型方法:`map` 把 `Box<T>` 变成 `Box<R>`。
class Box<T> {
  const Box(this.value);

  final T value;

  Box<R> map<R>(R Function(T value) transform) => Box<R>(transform(value));

  T getOrElse(T fallback) => value;

  @override
  bool operator ==(Object other) => other is Box<T> && other.value == value;

  @override
  int get hashCode => Object.hash(T, value);

  @override
  String toString() => 'Box<$T>($value)';
}

/// 双泛型参数:键值对。注意 Dart 的泛型参数顺序即类型顺序,没有 Go 的 `[K comparable, V any]` 约束语法。
class Pair<K, V> {
  const Pair(this.key, this.value);

  final K key;
  final V value;

  /// 交换键值,两个泛型参数对调。
  Pair<V, K> get swapped => Pair<V, K>(value, key);

  @override
  String toString() => '($key: $value)';
}

/// 运行期类型判定:`List<int>` 与 `List<String>` 是不同的类型(Go 做不到这点)。
bool isIntList(Object value) => value is List<int>;

/// 泛型 + 约束的常见组合:只要 `num` 就够用时,用 `T extends num` 而不是 `Comparable`。
/// 需要一个 `seed` 是因为 Dart 没有"`T` 的零值"概念(Go 有 `var zero T`),
/// 不能凭空造出一个 `0` 来当累加初值。
T sumOf<T extends num>(List<T> xs, {required T seed}) {
  var total = seed;
  for (final x in xs) {
    total = (total + x) as T; // num 的 + 返回 num,转回 T 是安全的:T 只会是 int 或 double
  }
  return total;
}

/// **协变(covariance)陷阱**:`List<int>` 是 `List<num>` 的子类型,
/// 所以可以赋给 `List<num>`;但往里面塞 double 会在**运行期**抛 `TypeError`。
///
/// 这是 Dart(和 Java、C# 数组)的设计:读安全、写不安全,靠运行期检查兜底。
/// Go 的泛型是编译期严格检查,没有这种洞;C 更不存在。
List<num> widenToNum(List<int> xs) => xs;

void addDouble(List<num> xs) => xs.add(1.5);

代码构成:dart 27 KB · text 11 KB · yaml 400 B

本地运行

zip → 解压 → 执行
$cd examples/ch03-types-collections && dart pub get && dart run

这个 zip 里有什么

  • • 完整工程目录(含 Android / iOS / 桌面平台脚手架)
  • • lib / bin / test / native 全部源码与测试
  • • pubspec.yaml、锁文件与平台配置文件
  • • 已排除 .dart_tool / build / target / ephemeral 等构建产物

已验证

  • dart analyze(0 告警)、dart test(32 个用例全绿)
查看全部示例