Skip to content

0.2.0

Choose a tag to compare

@github-actions github-actions released this 16 Aug 11:24
· 7 commits to main since this release
ecb33c0

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

  1. Download the appropriate archive for your platform
  2. Extract the archive
  3. The package contains:
    • lib/libjcccol.a — Static library
    • include/jcccol.h — Umbrella header
    • include/jcccol/ — Per-module headers
    • README.md — Documentation
    • LICENSE — 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.