language-ext 中 Nullable<T> 的单子化:把 .NET 可空值类型接入函数式组合
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:单向分支与兜底值
ifSome仅处理有值分支,无值时什么都不做,返回unit(Nullable.Prelude.cs);ifNone提供兜底值或惰性兜底函数(Nullable.Prelude.cs):
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 等安全消解手段。
六、适用边界与最佳实践小结
- 适用前提:所有
Nullable单子函数都要求T : struct——string、byte[]等引用类型请改用Option<T>; - 组合优先:把
int?提升为Option<int>后即可享受 language-ext 完整的 LINQ 单子语法(from … in … select …)与map/bind/filter链; - 显式消解:需要读取值时,用
match/ifSome/ifNone显式覆盖两条分支,避免.Value在null上抛InvalidOperationException; - 错误语义:当缺失需要携带业务含义(错误码、消息)时,用
toEither把null升级为Either<L, R>的Left; - 集成遗留代码:
ToOption()是连接“遗留int?返回值”与“函数式内核Option<int>”的桥梁,ToNullable()则用于在边界处还原成 .NET 原生类型。
相关源码入口:Nullable.Prelude.cs(全部变换与分支函数)、Option.Extensions.cs(ToNullable)、Alternative Monads 总览(Nullable 在单子谱系中的定位)、OptionTests.cs(可空语义的测试印证)。