ios - 找不到 swift darwin 文档

Question

我正在玩 swift 并有以下简单代码

我想检查“sqrt”函数是如何实现的，所以我尝试点击“Darwin.C.math”链接但没有任何反应。我用谷歌搜索“Swift darwin apple documentation”，但没有找到任何关于“Darwin”的信息。那么有人可以告诉我如何找到有关“sqrt”函数的文档吗？

在java中，当我点击一个类名或一个方法名时，会出现源代码文件，里面包含了方法和类是如何实现的所有细节。但我似乎无法对 swift/xcode 做同样的事情。

Answer 1

sqrt 的文档可通过运行 man sqrt 获得。大多数 Darwin 函数都是桥接到 Swift 的 C 函数，它们没有记录在 Xcode 中。

但是您要求的是实现，这与文档完全不同。要为您提供实现，您必须拥有所有源代码，而像 stdlib、Foundation 和 Darwin 之类的东西不会直接提供，因为它们是预编译的。其中一些是开源的，因此原则上您可以找到源代码，但仍然很难知道这正是您正在使用的代码。这是非常典型的编译语言，因为没有简单的方法来反编译它们。

也就是说，正如 Ben 所说，如果您知道去哪里找，大部分源代码都可以在不同的地方找到。不过，sqrt(Double) 是一个很好的失败示例，因为没有按照您可能想到的方式实现。它由编译器通过 __builtin_sqrt 直接内联.在 Intel 处理器上，可以直接转换为 fsqrt operation ，它可能被矢量化，它可能在编译时被评估，或者它可能以各种其他方式内联。在不同的平台上，有不同的选择。

在您的示例中，它是在编译时计算并编码的，就好像您编写了 var result = 3.0。您可以在 LLVM IR 输出中看到这一点:

echo "import Darwin; var result = sqrt(9.0)" | swiftc -emit-ir -O -

...
define i32 @main(i32, i8** nocapture readnone) local_unnamed_addr #0 {
entry:
  store double 3.000000e+00, double* getelementptr inbounds (%TSd, %TSd* @"$S4main6resultSdvp", i64 0, i32 0), align 8
  ret i32 0
}
...

因此没有任何您可以提出的“实现”。没有真正的 sqrt 函数(尽管至少某些版本的 macOS 有 a fake one )。

也就是说，我同意相关的手册页没有以某种方式导入到 Xcode 中确实很烦人。这样做可能需要做很多工作，因为这些函数的文档是用 troff 编写的，这可能很难转换为 Xcode 使用的文档格式，但即使这样也很好。