clojuredocs.org 上的语义符号代表什么？

Question

我想知道如何在 https://docs.clojure.org 的条目第二行中理解这些字符的含义。

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

该页面第一行是

prn

第二行是

(prn & more)

代码 (prn & more) 的含义是什么？我该如何理解它？特别是，我该如何理解这个符号 &？

这里使用的符号让我想起了用于表示编程语言语法的“语义”扩充巴科斯-诺尔形式（https://en.wikipedia.org/wiki/Augmented_Backus–Naur_form），以及通常在程序帮助条目中给出的用法说明。

然而，似乎没有关于如何解释这种特定语义的文档，无论这是否是情况。

我特别想知道如何解释 &。

如果某处有解释此内容的页面，我希望它从 https://docs.clojure.org 的每个条目中链接。

Answer 1

ClojureDocs在文档化函数签名时移除了最外层的括号。不清楚为什么——可能为了避免杂乱。如果您访问代码中的“prn”网页并点击顶部右角的“源代码”，会看到其签名为[& more]。

关于符号——它们都已在Clojure网站上进行了文档化。特别是，这里的&表示该函数是变长参数函数：https://www.clojure.org/guides/learn/functions#_variadic_functions

Answer 2

这可能有帮助

https://clojure.org/guides/weird_characters

Answer 3

这意味着prn可能有多重参数。

• https://stackoverflow.com/questions/35412976/in-clojure-what-does-mean-in-function-macro-signature

Answer 4

clojuredocs.org首页有一个链接，“如果您有如何改善ClojureDocs的建议，请发起工单”。

Clojure的官方（或者说）API文档位于https://clojure.github.io/clojure/（由clojure.org链接）。

希望clojuredocs.org能仔细考虑并采用您的建议。clojure.org的文档倾向于将说明与参考严格区分。