iodine Standard Library

Browse the iodine libraries for output, strings, regular expressions, file I/O, processes, and synchronization.

iodine is the i++ standard library. Its modules provide higher-level routines in i++ and use lower-level Linux x86_64 assembly backends where needed.

The linked source repository stores these library sources in plstd/ with the .plib extension. This documentation treats them as .ih files in the iodine/ library, as used by i++.

Library guides

Output

Format terminal output with printd.

Strings

Compare, copy, concatenate, and search strings.

Regular expressions

Search with find and split text with split.

File I/O

Read, write, measure, copy, and remove files.

Processes and threads

Work with Linux processes, threads, and futex-based mutexes.

Rocket

Check the status of the currently empty placeholder file.

Module inventory

Import public modules from the iodine/ library. The _x86 files are lower-level assembly implementations used by their higher-level libraries; do not import those backends directly.

Library	Layer	Guide
iodine/printd.ih	Formatted output, with an inline assembly write wrapper	Output
iodine/regex.ih	Pattern search and splitting	Regular expressions
iodine/rocket.ih	Empty placeholder; no API yet	Rocket
iodine/spoon.ih	Processes, threads, and synchronization	Processes and threads
iodine/streamer.ih	Higher-level file and stream API	File I/O
iodine/streamer_x86.ih	Linux x86_64 assembly syscalls used by streamer.ih	Internal backend
iodine/string.ih	Higher-level string API	Strings
iodine/string_x86.ih	Linux x86_64 assembly routines used by string.ih	Internal backend

Import a library

Import the library module you need. You can expose a function for direct calls or keep access qualified with @lib:

Expose a function

using printd from <iodine/printd>;
expose printd;

int main() {
    printd("value: %d", 42);
    return 0;
}

Keep the namespace

using printd from <iodine/printd>;

int main() {
    printd@lib("value: %d", 42);
    return 0;
}

See the syntax guide for import and namespace details.

Installation paths

The compiler looks for libraries under PLIBS/. Keep iodine modules in the iodine/ subdirectory:

Scope	Path
System	/usr/lib/PLIBS/iodine/
User	~/.local/lib/PLIBS/iodine/

Use the compiler’s library options to install or remove a library:

hypotenuse -i iodine/printd.ih
hypotenuse -r printd

The current iodine source lives in the plstd/ directory of the C△ repository. The guides here describe the Linux x86_64 implementation.