位左移和位右移的哪个参数是哪个？

Question

对于 (bit-shift-left x n) 的 docstring 只有 "位左移" 的描述。它没有定义 x 或 n。

在 docstring 下方有源代码的链接，但它并没有立即解答问题，因为它调用 clojure.lang.Number 的一个方法。

建议：增强 docstring，例如 "将 x 左移 n 位"。

附言：如今左移在所有地方都代表"更有意义"吗？随着 Clojure 在 JS 以及更陌生的环境下实现，docstring 是否可以说明 Clojure 的左移和右移是否具有特定的数学意义（如 Java 语言规范中所述）或具有宿主相关的意义？

补充附言：同样对于 bit-shift-right。

特别补充：同样在 ClojureScript 的 docstring 中。

Answer 1

已提交 jira: https://clojure.atlassian.net/browse/CLJ-2608

Answer 2

您可以在REPL中轻松获得答案。

clj Clojure 1.10.1 (bit-shift-left 1 1) 2 (bit-shift-left 1 2) 4 (bit-shift-left 1 3) 8 (bit-shift-left 1 4) 16 (bit-shift-left 2 1) 4 (bit-shift-left 2 3) 16

这些答案将是正确的。即使您在SNES上运行定制的16位JVM，或者在奇特的javascript引擎上运行也是如此 ;)

Comments

这个问题是关于改进docstrings的。