Documentation on alternative radix/0-prefixed numbers

Question

The data structures section on numbers (https://clojure.org/reference/data_structures#Numbers) doesn't mention any of the alternate radix numbers. Reading the code in LispReader is challenging, I'm not exactly sure how it should work. Is there another place this is documented? If not, can the various ways be documented?

Here's what I've discovered from reading the regex and code, not sure which of this is intentional or undefined behavior:

0      ; 0
+0     ; 0
+0N    ; 0N
1      ; 1
-1     ; -1
123    ; 123
123N   ; 123N
0x1A   ; 26
0x1AN  ; 26N
012    ; 10
012N   ; 10N
12r1   ; 1
12r1N  ; fails
12r2a  ; 34
12r2aN ; fails

Answer 1

There are some docs on the reader page under https://clojure.org/reference/reader#_literals

Those examples all look right to me.

Comments

Thanks, I didn't think to read that page. Would you be interested in either having a dedicated Numbers or Literals page or linking from Data structures to this so folks don't read the reader page can still find the relevant information? In my opinion, "Reader" feels like implementation or low-level details, not definitions of data types.

---

In this case, the syntax is about reading numbers in your code. Once they are read, they are just longs or whatever, so this is really a syntax thing and that's what is defined on the Reader page.

---

Alright, thanks.