关于使用Internal`Bag和任何官方文档？

Question

(Mathematica版本:8.0.4)

lst = Names["Internal`*"];
Length[lst]
Pick[lst, StringMatchQ[lst, "*Bag*"]]

给

293    
{"Internal`Bag", "Internal`BagLength", "Internal`BagPart", "Internal`StuffBag"}

Mathematica编程指南作者:迈克尔·特罗特,第494页,内部背景说

"但与Experimental`上下文相似,不能保证在Mathematica的更高版本中仍然可以使用这些函数的行为和语法"

另外,这里提到的Bag功能:

在Mathematica中实现四叉树

但是,由于我已经看到Mathematica专家在这里建议Internal`Bag功能并自己使用它们,我假设在实际代码中使用它们会有点安全吗？若然,我有以下问题:

我在哪里可以找到这些函数(API等)的更正式的描述,就像在文档中心找到的那样？ 现在没有任何关于他们的事情

??Internal`Bag
Internal`Bag
Attributes[Internal`Bag]={Protected}

如果我开始使用它们,我会发现很难通过查看一些示例和反复试验来了解它们的功能.我想知道这里是否有人可能有一个更完整和自包含的文档,使用这些,描述API和更多已经存在的内容或链接到这样的地方.

Answer 1

上下文Internal正如其名称所示：供 Wolfram 开发人员内部使用。

这意味着，除其他外，您可能在其中找到的任何内容都包含以下内容：

• 您很可能无法找到任何有关它的官方文档，因为它不适合公众使用。
• 对于无效参数来说，它不一定那么强大。（其中一些很容易导致内核崩溃。）
• API 可能会更改，恕不另行通知。
• 该功能可能会完全消失，恕不另行通知。

现在，在实践中，其中一些可能相当稳定，但我强烈建议您远离它们。使用未记录的 API 很容易让您在未来遭受很多痛苦和令人讨厌的意外。