language-ext 中 Nullable<T> 的单子化:把 .NET 可空值类型接入函数式组合

原创2026-09-28 15:52:231,603 阅读
文章标签:后端

language-ext 中 Nullable<T> 的单子化:把 .NET 可空值类型接入函数式组合

language-ext(C# 纯函数式编程框架)为 .NET 原生的 Nullable<T> 提供了完整的一等公民单子(monad)支持:你可以把 int?、decimal? 这类可空值类型直接用在 LINQ 查询表达式、map/bind/filter 组合链以及类型自然变换中,并借助 match、ifSome、ifNone 等分支函数优雅地消除对 HasValue 的显式判断。读完本文,你将掌握 language-ext 如何把 Nullable<T> 变成可用 LINQ 组合的可空单子、全部内建变换与分支函数的行为细节,以及在 Option<T>、Either<L,R> 之间互转的标准姿势。

一、从“可空值”到“可空单子”:Nullable<T> 在 language-ext 中的定位

在 .NET 中,Nullable<T>(即 T?,仅限值类型)一直承担着“值或缺失”的表达职责。而 language-ext 的 Alternative Monads 文档 将这类类型统一归入“可替换值单子”(Alternative Monads):它们都可以看作 Either 的特化,区别只在于承载“替换值”(alternative value)的类型不同。

类型 替换值类型 绑定值类型 说明
Either<L, R> L R 原型
Fin<A> Error A 等价于 Either<Error, A>
Try<A> Error A 等价于 Either<Error, A>(且捕获异常)
Option<A> None A 等价于 Either<Unit, A>
Nullable<A> null A 等价于 Either<Unit, A>
Validation<Fail, Succ> Fail Succ Fail 需满足 Monoid<Fail> 以收集错误

因此 Nullable<A> 的“替换值”就是 null,它的“绑定值”就是有值的那个 A。理解了这一定位,就理解了下文所有变换与分支函数的设计动机:在值类型上把 null 变成可组合的缺失态。

二、核心能力:让 Nullable<T> 参与 LINQ 查询与组合

该模块的核心承诺是:Nullable<T> 可以像 Option<T>、Either<L,R> 等其他单子类型一样直接使用于 LINQ 表达式。例如:

// 传统写法:层层 if 判空
int? a = 10;
int? b = 5;
int? result = null;
if (a.HasValue && b.HasValue)
{
    result = a.Value + b.Value;
}

// language-ext 风格:像组合 Option 一样组合 Nullable
var sum = from x in a
          from y in b
          select x + y;

链式调用同样成立——map、bind、filter 是构造这类表达式的基础构件,它们全部定义在 Nullable.Prelude.cs 中(方法均标注 [Pure],无副作用):

int? x = 10;

// map:有值则变换,无值保持 null
int? doubled = map(x, v => v * 2);          // 20

// bind:有值则调用 binder,无值传播 null
int? y = bind(x, v => v > 5 ? (int?)v * 3 : null);  // 30

// filter:有值且满足谓词则保留,否则归 null
int? z = filter(x, v => v % 2 == 0);        // 10(10 是偶数)
int? w = filter(x, v => v % 3 == 0);        // null(10 不是 3 的倍数)

从源码看,三者均以 self.HasValue 作为唯一判空依据:map 在无值时返回 default(R?),bind 在无值时返回 default(即 null),filter 在谓词不满足时同样回落到 default——缺失状态在整条链上被透明传播(Nullable.Prelude.cs)。

注意:Nullable<T> 只能用于值类型,因此这些泛型函数都有 where T : struct 约束;而 language-ext 的 Option<A> 没有该限制,这正是两者在职责上的分界点。

三、Option<int> mx = x.ToOption(); 与全部自然变换

文档给出的示例揭示了最常用的转换路径——把可空值“提升”进 Option<T>:

int? x = ...;
Option<int> mx = x.ToOption();

在语言层面 language-ext 提供两种等价入口:

  • ToOption() 扩展方法:x.ToOption(),用于 LINQ 风格调用;
  • toOption 前奏函数:toOption(x),与框架其他 Prelude 函数风格一致。

二者的实现完全一致(Nullable.Prelude.cs):

[Pure]
public static Option<T> toOption<T>(T? self) where T : struct =>
    self.HasValue
        ? Some(self.Value)
        : None;

即:HasValue 为真 → Some(value);否则 → None。反向转换同样可用——Option<A> 的 ToNullable<A>() 扩展方法(Option.Extensions.cs)把 None 映射为 null:

public static A? ToNullable<A>(this Option<A> ma) where A : struct =>
    ma.IsNone
        ? null
        : ma.Value;

两者合在一起,Nullable<T> 与 Option<T> 之间可以无损往返,这在“遗留代码返回 int?、函数式内核消费 Option<int>”的混合架构中尤其实用。

3.1 转成 Either<L, R>:为缺失值携带语义

除了 Option,Nullable 还可以转换为 Either<L, R>。当需要为“无值”附带业务含义(例如错误码)时,使用带 L 参数的 toEither(Nullable.Prelude.cs):

// 固定左值
Either<string, int> e1 = toEither(x, "value is missing");

// 惰性左值(仅在缺失时求值)
Either<string, int> e2 = toEither(x, () => "value is missing");

3.2 append:语义化拼接与半群(Semigroup)支持

append 把两个可空值按半群规则合并(Nullable.Prelude.cs):

public static T? append<T>(T? lhs, T? rhs)
    where T : struct, Semigroup<T>

其合并表为:None + None = None、Value + None = Value、None + Value = Value、Value + Value = lhs.Value.Combine(rhs.Value)。这意味着:

  • 数值:做求和;
  • 字符串:做拼接;
  • Lst/Stk/Que:做连接;
  • Map/Set:做合并;
  • 其他实现 Semigroup<T> 的类型:调用 lhs.Append(rhs)。

类似地,plus、subtract、product、divide 通过 Arithmetic<T>/Num<T> 数值特征对两个“有值”部分做算术运算,并遵循“任一侧为 null 时按中性元素处理”的规则(如 product 中任一为 null 即结果为 null,divide 中 zero / rhs = zero、lhs / zero = undefined,见 Nullable.Prelude.cs)。

四、分支与消解:告别 if (x.HasValue)

Nullable.Prelude.cs 提供了一组把“有值/无值”二分状态显式化的函数,全部依赖 HasValue 分支,帮助你在不抛异常、不写散乱 if 的情况下完成模式匹配。

4.1 match:完整的双分支

// 返回非空 R
R r = match(x,
    v  => $"value: {v}",   // Some 分支
    () => "no value");     // None 分支

// 返回 Unit 的命令式版本
match(x,
    v  => Console.WriteLine(v),
    () => Console.WriteLine("no value"));

源码中还有两个 matchAsync 重载(Nullable.Prelude.cs),分别要求 Some 处理器返回 Task<R>、以及要求 Some/None 都返回 Task<R>,便于在异步流程里分支:

int result = await matchAsync(x,
    async v  => await LoadAsync(v),
    ()       => 0);

4.2 ifSome / ifNone:单向分支与兜底值

int a = ifNone(x, 0);              // 无值 → 0
int b = ifNone(x, () => ComputeDefault());

4.3 iter、count、forall、exists:集合视角的折叠操作

把可空值想象成“最多一个元素”的集合,这些函数的行为就一目了然:

  • iter:有值则执行 action(Nullable.Prelude.cs);
  • count:有值返回 1,无值返回 0(Nullable.Prelude.cs);
  • forall:无值时返回 true(空集全称量化自然成立),有值则交由谓词判断;也提供 Some/None 双谓词重载(Nullable.Prelude.cs);
  • exists:无值时返回 false,有值则交由谓词判断;同样提供双谓词重载(Nullable.Prelude.cs)。
bool allPositive = forall(x, v => v > 0);   // 无值 → true
bool anyBig      = exists(x, v => v > 100); // 无值 → false

4.4 somes:从集合中提取全部有值元素

somes 遍历 IEnumerable<T?>,按原顺序 yield return 出所有 HasValue == true 的底层值,是“过滤空值”的惯用工具(Nullable.Prelude.cs):

int?[] xs = { 1, null, 3, null, 5 };
IEnumerable<int> values = somes(xs);   // 1, 3, 5

4.5 sum:有值取数,无值归零

sum 是给 int? 定制的快速兜底函数(Nullable.Prelude.cs):

public static int sum(int? self) => self ?? 0;

五、与测试遥相印证:可空性与 Option 的组合语义

语言层面的设计在测试中同样有迹可循。在 OptionTests.cs 中,GetNullable(bool) 返回 Option<int>(true → Some(1000),false → None),并验证了:

  • NullableTest:GetNullable(true).Some(v => v).None(() => 0) 结果为 1000——有值分支生效;
  • NullableDenySomeNullTest:对 None 状态强行执行 Some 分支会抛出 ValueIsNullException——这正是 language-ext 强调“缺失必须显式消解”、拒绝静默空值的设计哲学。

从实现看,ToOption() / toOption 与 ToNullable() 双向转换让 Nullable<T> 与 Option<T> 语义完全对齐:HasValue ↔ IsSome、null ↔ None,因此任何需要“显式处理缺失”的新代码都可以先提升为 Option<T> 再使用 match/ifNone 等安全消解手段。

六、适用边界与最佳实践小结

  1. 适用前提:所有 Nullable 单子函数都要求 T : struct——string、byte[] 等引用类型请改用 Option<T>;
  2. 组合优先:把 int? 提升为 Option<int> 后即可享受 language-ext 完整的 LINQ 单子语法(from … in … select …)与 map/bind/filter 链;
  3. 显式消解:需要读取值时,用 match / ifSome / ifNone 显式覆盖两条分支,避免 .Value 在 null 上抛 InvalidOperationException;
  4. 错误语义:当缺失需要携带业务含义(错误码、消息)时,用 toEither 把 null 升级为 Either<L, R> 的 Left;
  5. 集成遗留代码:ToOption() 是连接“遗留 int? 返回值”与“函数式内核 Option<int>”的桥梁,ToNullable() 则用于在边界处还原成 .NET 原生类型。

相关源码入口:Nullable.Prelude.cs(全部变换与分支函数)、Option.Extensions.cs(ToNullable)、Alternative Monads 总览(Nullable 在单子谱系中的定位)、OptionTests.cs(可空语义的测试印证)。

登录后查看全文
language-ext