docs(spec): split range bounds from counts; pin inline-for range semantics (0083)
specs.md lumped `inline for` / `for` range bounds in with counts (array dimension, Vector lane count, generic value-param count) under the count negative-rejection rule. A range bound is a range ENDPOINT, not a count: negative endpoints are valid and an empty/inverted range runs zero iterations. The compiler already implements this correctly (Agra ruling: spec-text bug, no code change). - specs.md: counts and range bounds are now described separately. Counts reject negatives; bounds accept any compile-time integer (negatives valid, integral floats fold) but still reject a non-integral float because the loop cursor must be an integer. - examples/0612-comptime-inline-for-range-bounds.sx: `inline for -2..1` and `for -2..1` both sum -3; `inline for 0..(-2.0)` runs zero iterations (empty range). Runtime/comptime parity asserted. - examples/1138-diagnostics-inline-for-non-integral-bound.sx: a non-integral float bound `inline for 0..4.5` is a clean diagnostic, exit 1 (must-be-integer still applies to bounds). Count consumers (1132/1133/1134/1135) unchanged and green.
This commit is contained in:
24
examples/0612-comptime-inline-for-range-bounds.sx
Normal file
24
examples/0612-comptime-inline-for-range-bounds.sx
Normal file
@@ -0,0 +1,24 @@
|
|||||||
|
// An `inline for` / `for` range bound is a range ENDPOINT, not a count, so the
|
||||||
|
// count negative-rejection rule does NOT apply to it: negative endpoints are
|
||||||
|
// valid and an empty/inverted range simply runs zero iterations.
|
||||||
|
//
|
||||||
|
// Regression (F0.4 attempt 11, Agra ruling): the spec wrongly lumped inline-for
|
||||||
|
// bounds with counts (array dim / Vector lane / value-param), which reject
|
||||||
|
// negatives. Bounds are exempt — `inline for -2..1` iterates -2,-1,0 and an
|
||||||
|
// integral-float empty range `0..(-2.0)` runs zero iterations. Comptime and
|
||||||
|
// runtime loops must agree.
|
||||||
|
#import "modules/std.sx";
|
||||||
|
|
||||||
|
main :: () {
|
||||||
|
s := 0;
|
||||||
|
inline for -2..1: (i) { s += i; }
|
||||||
|
print("inline for -2..1 sum = {}\n", s); // -2 + -1 + 0 = -3
|
||||||
|
|
||||||
|
r := 0;
|
||||||
|
for -2..1: (i) { r += i; }
|
||||||
|
print("for -2..1 sum = {}\n", r); // -2 + -1 + 0 = -3 (runtime parity)
|
||||||
|
|
||||||
|
e := 0;
|
||||||
|
inline for 0..(-2.0): (i) { e += i; }
|
||||||
|
print("inline for 0..(-2.0) sum = {}\n", e); // empty range -> 0 iterations
|
||||||
|
}
|
||||||
14
examples/1138-diagnostics-inline-for-non-integral-bound.sx
Normal file
14
examples/1138-diagnostics-inline-for-non-integral-bound.sx
Normal file
@@ -0,0 +1,14 @@
|
|||||||
|
// A NON-integral float (`4.5`) as an `inline for` range bound is a hard error:
|
||||||
|
// the loop cursor must be a compile-time integer, so only an integral float
|
||||||
|
// (`4.0`, `-2.0`) folds. Clean diagnostic + non-zero exit.
|
||||||
|
//
|
||||||
|
// Regression (F0.4 attempt 11, Agra ruling): range bounds are exempt from the
|
||||||
|
// count negative-rejection (negatives are valid endpoints), but the
|
||||||
|
// must-be-integer requirement still applies — `4.5` has no integer value.
|
||||||
|
#import "modules/std.sx";
|
||||||
|
|
||||||
|
main :: () {
|
||||||
|
s := 0;
|
||||||
|
inline for 0..4.5: (i) { s += i; }
|
||||||
|
print("unreachable: {}\n", s);
|
||||||
|
}
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
0
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
|
||||||
@@ -0,0 +1,3 @@
|
|||||||
|
inline for -2..1 sum = -3
|
||||||
|
for -2..1 sum = -3
|
||||||
|
inline for 0..(-2.0) sum = 0
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
1
|
||||||
@@ -0,0 +1,5 @@
|
|||||||
|
error: inline for: range end is not a compile-time integer
|
||||||
|
--> examples/1138-diagnostics-inline-for-non-integral-bound.sx:12:19
|
||||||
|
|
|
||||||
|
12 | inline for 0..4.5: (i) { s += i; }
|
||||||
|
| ^^^
|
||||||
@@ -0,0 +1 @@
|
|||||||
|
|
||||||
19
specs.md
19
specs.md
@@ -651,11 +651,20 @@ Arrays can also be constructed programmatically with the `Array` builtin:
|
|||||||
MyArr :: Array(5, s32); // equivalent to [5]s32
|
MyArr :: Array(5, s32); // equivalent to [5]s32
|
||||||
```
|
```
|
||||||
|
|
||||||
An array dimension — and likewise a `Vector` lane count, a generic value-param
|
A **count** — an array dimension, a `Vector` lane count, or a generic
|
||||||
count, and an `inline for` bound — accepts any compile-time numeric constant
|
value-param count — accepts any compile-time numeric constant whose value is a
|
||||||
whose value is a positive integral number. An integral float (`4.0`, or a
|
positive integral number. An integral float (`4.0`, or a float-typed const
|
||||||
float-typed const `N : f64 : 4.0`) folds to its integer (`[4.0]s64` ≡ `[4]s64`);
|
`N : f64 : 4.0`) folds to its integer (`[4.0]s64` ≡ `[4]s64`); a non-integral
|
||||||
a non-integral float (`4.5`) or a negative value is rejected.
|
float (`4.5`) or a negative value is rejected.
|
||||||
|
|
||||||
|
A **range bound** — the start/end of an `inline for` or `for` range — is a
|
||||||
|
range *endpoint*, not a count, so the count rules above do not apply. A bound
|
||||||
|
accepts any compile-time **integer**, including a negative one; an integral
|
||||||
|
float (`-2.0`) folds to its integer. A non-integral float (`4.5`) is still
|
||||||
|
rejected, because the loop cursor must be a compile-time integer. Negative
|
||||||
|
endpoints are valid: `inline for -2..1` iterates `-2, -1, 0`. An empty or
|
||||||
|
inverted range (start ≥ end, e.g. `0..(-2.0)`) simply runs zero iterations
|
||||||
|
rather than being an error.
|
||||||
|
|
||||||
### Slice Types
|
### Slice Types
|
||||||
A slice `[]T` is a fat pointer `{ptr, i64}` referencing a contiguous sequence of `T` elements. Same runtime layout as `string`.
|
A slice `[]T` is a fat pointer `{ptr, i64}` referencing a contiguous sequence of `T` elements. Same runtime layout as `string`.
|
||||||
|
|||||||
Reference in New Issue
Block a user