2024年Clojure问卷调查!中分享您的想法。

欢迎!请参阅关于页面以获取更多有关如何使用本网站的信息。

0
文档

我想知道在https://docs.clojure.org条目的第二行上代表什么字符。

例如,访问https://docs.clojure.org/clojure.core/prn

该页面的第一行是

prn

该第二行是

(prn & more)

(prn & more)是什么意思?我怎么理解这个?特别是,我如何解释这个和号&

这里使用的符号让我想起了用于表达编程语言语法的“元语言”增强巴科斯-诺尔形式(《https://en.wikipedia.org/wiki/Augmented_Backus%E2%80%93Naur_form》),以及帮助条目中常给出的使用指南。

然而,我在任何地方都没有看到有关如何解释这种特定的元语言的说明,如果这就是这里发生的事情的话。

我特别想知道如何解释&

如果某个页面解释了这一点,我希望它能从https://docs.clojure.org上的每个条目中链接出来。

4个答案

+1

被选中
 
最佳答案

ClojureDocs 在注释函数签名时会移除最外层的括号。不确定为何这样做,可能是为了减少混乱。如果你访问 prn 的网页,并点击右上角的 "源代码",你会看到它的签名是 [&更多]

关于符号——它们都在 Clojure 网站上有记录。特别是,这里的 & 表示函数是可变长的:[可变长函数的介绍](https://www.clojure.org/guides/learn/functions#_variadic_functions)

+1
by
0
by
0
by

clojuredocs.org 的主页有一个链接,"如果您有任何改进 ClojureDocs 的想法,请提票"。

Clojure 的官方(可以这样说)API 文档在 https://clojure.github.io/clojure/(由 clojure.org 提供)。

希望 clojuredocs.org 会认真考虑你的建议。clojure.org 的文档通常严格区分指南和参考。

...