clojuredocs.org 上的元语言风格符号代表什么？

Question

我想了解 https://docs.clojure.org 条目第二行中的字符表示什么。

例如，请转到 https://docs.clojure.org/clojure.core/prn。

该页面的第一行是

prn

第二行是

(prn & more)

《prn & more》这个表示法是什么意思？我该如何解释它？特别是在如何解释 ampersand & 方面。

这里使用的表示法让我想起了“金属语言”扩展的巴科斯-诺尔范式（ABNF），用于表示编程语言的语法，以及帮助条目通常给出的程序使用说明。

但是，我看不到任何有关如何解读这种特定金属语言的文档，即使这是在这里发生的情况。

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

如果某处有页面解释这个，我希望它能从 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的文档往往严格区分指导和参考。