fe76fb97cb
mnemonic_builders.odin bakes `global_index + 1` into Instruction.enc_hint so the encoder can skip the O(forms) match scan. The index is GLOBAL, so any edit to the encoding table that inserts or removes a form shifts every index after it and leaves the builders naming another instruction's encoding -- and nothing noticed: the encoder took the form, emitted its bytes and returned success. It has happened twice.6e17e7a2dleft 2130 of 3671 builders wrong;36af73834regenerated both halves and cleared it;baae2636b(adding `in`/`out`) re-broke 37;9ae9a9bf9shifted an early mnemonic and broke 3393 of 3802 -- including CALL, whose r/m64 builder then encoded 0F 8A (JPE) instead of FF /2, turning every indirect call into a conditional jump. The symptom was a segfault in a JIT'd program, arbitrarily far from the cause. Regenerated: 3820 of 3820 builders now correct. Three guards so it cannot return silently: - the encoder checks, under ODIN_DEBUG, that the hinted form lies inside its own mnemonic's ENCODE_RUNS entry. Release keeps the byte-for-byte fast path; this is a regeneration-time mistake and only has to be caught once by anyone running tests. - the generator stamps BUILDER_TABLE_FINGERPRINT, an FNV-1a hash of every ENCODE_RUNS (start, count), into the file it emits. - run_builder_generation_test recomputes it from the loaded tables and fails with the command to regenerate. Known-failing at this commit: four SAL/SHL cases, a separate defect in the alias table, fixed in the commit that follows. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Riok9vMpkLmo78wsVKJHhz
The Data-Oriented Language for Sane Software Development.
The Odin Programming Language
Odin is a general-purpose programming language with distinct typing, built for high performance, modern systems, and built-in data-oriented data types. The Odin Programming Language, the C alternative for the joy of programming.
Website: https://odin-lang.org/
package main
import "core:fmt"
main :: proc() {
program := "+ + * 😃 - /"
accumulator := 0
for token in program {
switch token {
case '+': accumulator += 1
case '-': accumulator -= 1
case '*': accumulator *= 2
case '/': accumulator /= 2
case '😃': accumulator *= accumulator
case: // Ignore everything else
}
}
fmt.printf("The program \"%s\" calculates the value %d\n",
program, accumulator)
}
Documentation
Getting Started
Instructions for downloading and installing the Odin compiler and libraries.
Nightly Builds
Get the latest nightly builds of Odin.
Learning Odin
Overview of Odin
An overview of the Odin programming language.
Frequently Asked Questions (FAQ)
Answers to common questions about Odin.
Packages
Documentation for all the official packages part of the core and vendor library collections.
Examples
Examples on how to write idiomatic Odin code. Shows how to accomplish specific tasks in Odin, as well as how to use packages from core and vendor.
Odin Documentation
Documentation for the Odin language itself.
Odin Discord
Get live support and talk with other Odin programmers on the Odin Discord.
Articles
The Odin Blog
The official blog of the Odin programming language, featuring announcements, news, and in-depth articles by the Odin team and guests.
Warnings
- The Odin compiler is still in development.