函数 (bit-shift-left x n)
的文档字符串只说 "位左移",并没有定义 x
或 n
。
在文档字符串下面有一个链接到源代码,但它并没有立即解决疑问,因为它委托给了 clojure.lang.Number 的一个方法。
建议:增强文档字符串,例如“位左移 x,n 位”。
备注:如今左移在所有场合都表示 更重要的 吗?随着 Clojure 在 JS 和其他更奇怪的环境中实现,文档字符串能否明确指出 Clojure 的左移和右移是否有指定的数学意义(如 Java 语言规范中所述)或具有主机依赖的意义?
同样,还有 bit-shift-right
。
顺便说一下,ClojureScript 的文档字符串也是如此。