WOLFRAM

Wolfram 语言与系统参考资料中心

Enclose[expr]

尝试运算 expr 并返回结果，但若发现错误则停止并返回失败对象.

Enclose[expr,f]

将 f 应用于生成的任何失败对象.

Enclose[expr,"prop"]

对生成的任何失败对象给出属性 prop.

Enclose[expr,handler,form]

仅捕获标签明确指定且与 form 匹配的错误.

更多信息
Details and Options Details and Options
范例  
基本范例  
范围  
应用  
可能存在的问题  
参见
相关指南
历史
按以下格式引用：

Enclose

Enclose[expr]

尝试运算 expr 并返回结果，但若发现错误则停止并返回失败对象.

Enclose[expr,f]

将 f 应用于生成的任何失败对象.

Enclose[expr,"prop"]

对生成的任何失败对象给出属性 prop.

Enclose[expr,handler,form]

仅捕获标签明确指定且与 form 匹配的错误.

更多信息

范例

打开所有单元 关闭所有单元

基本范例  (2)

运算表达式，一旦抛出任何错误就退出：

Wolfram Language code: Enclose[2 + 2]
Wolfram Language code: Enclose[2 + 2;Confirm[$Failed];4 + 4]

创建一个稳健的函数：

Wolfram Language code: addtwo[x_] := Enclose[ConfirmBy[x, NumberQ] + 2]
Wolfram Language code: addtwo[4]
Wolfram Language code: addtwo[x]

范围  (6)

返回前处理错误：

Wolfram Language code: Enclose[2 + 2;Confirm[$Failed];4 + 4, f]

将 f 设置为 "Expression" 以传出错误，而不是封装在 Failure 中：

Wolfram Language code: Enclose[f[Confirm[Missing["NA"]]], "Expression"]

最里层的 Enclose 具有优先权：

Wolfram Language code: Enclose[a; Enclose[b; Confirm[$Failed]; c]; d]

使用标签将错误传到外层的 Enclose：

Wolfram Language code: Enclose[a;Enclose[b;Confirm[$Failed, None, "tag"];c];d, Identity, "tag"]

为 f 提供一个常数函数，以在发生任何错误时返回固定值：

Wolfram Language code: recip[x_] := Enclose[1 / ConfirmBy[x, GreaterThan[0] @* Abs], Missing[]&]
Wolfram Language code: recip[2]
Wolfram Language code: recip[0]

将错误传递到多个层：

Wolfram Language code: addtwo[x_] := Enclose[Confirm[x] + 2] framedAddtwo[x_] := Enclose[Framed[Confirm[addtwo[x]]]]
Wolfram Language code: framedAddtwo[5]
Wolfram Language code: framedAddtwo[$Failed]

通过嵌套确认执行多次确认：

Wolfram Language code: Enclose[f[ConfirmBy[ConfirmMatch[x, _Integer], EulerPhi[#] > 3&]]]

应用  (3)

安全地调用可能失败的函数，将错误不经更改而传播：

Wolfram Language code: cityPopulation[s_] := Enclose[Confirm[Interpreter["City"][s]]["Population"], "Expression"]
Wolfram Language code: cityPopulation["nyc"]
Wolfram Language code: cityPopulation["null island"]

在计算各国人均 GDP 时传播缺失值：

Wolfram Language code: Short[Enclose[Confirm[#[[1]]] / Confirm[#[[2]]], Missing[]&]& /@ EntityValue["Country", {"GDP", "Population"}]]

求在每对顶点之间都具有边的所有多面体，忽略没有 BoundaryMeshRegion 可用的多面体：

Wolfram Language code: Keys[Select[EntityValue["Polyhedron", "BoundaryMeshRegion", "EntityAssociation"], Enclose[CompleteGraphQ[MeshConnectivityGraph[Confirm[#], 2]], False&]&]]

可能存在的问题  (3)

Catch[…,_] 可以拦截错误：

Wolfram Language code: Enclose[Catch[Confirm[$Failed], _];d]

Enclose 不捕获由 Throw 抛出的表达式：

Wolfram Language code: Enclose[Throw[a];b]

如果未提供标签，则 Enclose 用词法将 Confirm 之类的符号用词法标记的变体替换：

Wolfram Language code: Enclose[Hold[Confirm]]
Wolfram Research (2020)，Enclose，Wolfram 语言函数，https://reference.wolfram.com/language/ref/Enclose.html.

文本

Wolfram Research (2020)，Enclose，Wolfram 语言函数，https://reference.wolfram.com/language/ref/Enclose.html.

CMS

Wolfram 语言. 2020. "Enclose." Wolfram 语言与系统参考资料中心. Wolfram Research. https://reference.wolfram.com/language/ref/Enclose.html.

APA

Wolfram 语言. (2020). Enclose. Wolfram 语言与系统参考资料中心. 追溯自 https://reference.wolfram.com/language/ref/Enclose.html 年

BibTeX

@misc{reference.wolfram_2026_enclose, author="Wolfram Research", title="{Enclose}", year="2020", howpublished="\url{https://reference.wolfram.com/language/ref/Enclose.html}", note=[Accessed: 15-September-2026]}

BibLaTeX

@online{reference.wolfram_2026_enclose, organization={Wolfram Research}, title={Enclose}, year={2020}, url={https://reference.wolfram.com/language/ref/Enclose.html}, note=[Accessed: 15-September-2026]}