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的想法，请打开一个ticket”。

Clojure的官方（可以说是）API文档在《https://clojure.github.io/clojure/》（通过clojure.org链接）。

希望clojuredocs.org能深思熟虑地采纳您的建议。clojure.org的文档倾向于严格区分指南和参考。