writeonce/docs/examples/operators

operators — iteration 36's manual-test workload

Exercises everything iteration 36 added to the language: boolean not, the five Int bitwise operators (& | ^ << >>), hex/binary/ underscore integer literals, and the five compound assigns (+= -= *= /= %=).

Run it

woc .            # from this directory
./target/operators

Every line prints ok <label> = <value> — each label states the exact expression and the expected result, so a manual test is reading the lines and spotting any FAIL. The sections, in order:

1. Literals — 0xFF, 0b1010_1010, 1_000_000 against their decimal twins.
2. The five operators — including -16 >> 2 = -4 (>> is ARITHMETIC: the sign bit extends, the story's settled decision 1) and complement spelled -1 ^ x (no ~ in this language).
3. Precedence pins — Go's C-trap fix: &/<</>> bind with *, |/^ bind with +, all above comparison, so x & mask == 0 groups the AND first and 1 << 4 + 1 is 17, not 32.
4. not — a word like and/or, Lua's unary placement: not a == b groups (not a) == b.
5. Compound assigns — one value threaded through all five.
6. The consumer proof — HMAC's ipad/opad step (story 34's blocker): byte_at(key, i) ^ 0x36 / ^ 0x5C in pure .wo.

The trap

./target/operators trap

must die with trap 12 in shift_by ...: shift count out of range 0..63 (exit 1). A shift count outside 0..63 is a RUN-TIME trap only when the count is a variable — a literal out-of-range count never compiles (WO-E223, try changing 1 << 6 to 1 << 64).