Home / Docs / Specification
29. Numerics
Status: Normative, v0.3 preview (ADR 0114; the chapter of the numeric foundation, ADR 0121 rule 20); §16 to §19 edition 0.5 preview (ADR 0120, and its amendment of 2026-11-06: ADR 0139 moved them from edition 0.4).
This chapter holds the numeric types beyond the integers of spec/03 and spec/18. It opens with F64, IEEE 754 binary64, the rules of ADR 0114; the other types of the numeric foundation (ADR 0120) join it in later sections: the dense values Array[T] and Matrix[T] of edition 0.5 are §17, F32 and the finite kinds §18, and the complex types Complex[F64] and Complex[F32] §19.
Editions. The rules of §1 to §15 apply only to packages of edition 0.3 (spec/13 §7) and later, and those of §16 to §19 only to packages of edition 0.5. Edition 0.4 has §1 to §15 and none of §16 to §19; spec/13 §7 lists what it reports for them, and which of those diagnostics advise edition 0.5. In editions 0.1 and 0.2, F64 is an ordinary name, 1.0 keeps its error (U0101), to_f64 resolves as any function name does, and the prelude has none of the functions of §3 rule 9.
What has landed. The front end, the checker, the interpreter, the verifier and native code implement this chapter, F32 and the finite kinds of §18 and the complex types of §19 included, except what §16 rule 14, §17, §18 rule 15 and §19 rule 10 list. Ranges with float bounds (x in 0.5..1.0) are syntax errors until a later step, and a range of integer bounds over an F64 is U2001.
Sections
- 29.1 The type
- 29.2 Literals
- 29.3 Operations
- 29.4 Conversions
- 29.5 Equality and order
- 29.6 Determinism
- 29.7 Text
- 29.8 Verification
- 29.9 Representation
- 29.10 JSON
- 29.11 Information flow
- 29.12 Units of measure
- 29.13 Editions
- 29.14 Cost
- 29.15 Diagnostics
- 29.16 Decimal
- 29.17 Dense values
- 29.18 F32 and the finite kinds
- 29.19 Complex[F64] and Complex[F32]