Repository navigation
0.2.0
libjcccol 0.2.0
The standard library for the COL programming language, designed for use with the JCC compiler.
What's Changed
COL string runtime — new <jcccol/strings.h>, adding concat, substr, indexof, string (from i64, f64, bool), readln and eof. Every string function returns a fresh block; allocation failure exits with a diagnostic rather than returning NULL.
Garbage collector — new <jcccol/jcc_gc.h>, vendored from libjccbas, since strings are COL's first heap type. Its symbols keep their upstream jcc_gc_* names because JCC emits those for both BASIC and COL.
Breaking: millis is now col_millis. Every exported symbol is col_-prefixed, with overloadable functions mangled col_<name>[_<type>...]. JCC-emitted IR references these names directly, so this is an ABI break. The vendored collector is the sole exception. See ADR 0001.
Known mismatch: col_string_bool returns "true"/"false", while jcc's println still prints booleans as 1/0, until println follows.
See the commit history for detailed changes.
Platform Support
This release includes a static library (libjcccol.a) for the following platforms:
- Windows x86_64 (Clang, MSYS2/MinGW64)
- Windows ARM64 (Clang, MSYS2/CLANGARM64)
- macOS ARM64 (Apple Silicon)
- macOS x86_64 (Intel)
- Linux x86_64
- Linux ARM64
Installation
- Download the appropriate archive for your platform
- Extract the archive
- The package contains:
lib/libjcccol.a— Static libraryinclude/jcccol.h— Umbrella headerinclude/jcccol/— Per-module headersREADME.md— DocumentationLICENSE— GPL-3.0 license text
Usage
Link COL programs against lib/libjcccol.a and add include/ to the compiler's include search path. See the JCC documentation for integration instructions.