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的签名是[...]。

关于符号，所有内容都在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的文档倾向于严格区分指南和参考。