Quickstart: Your First i++ Program

Create an i++ source file, compile it with the j++ compiler, and run it on Linux.

This guide assumes the j++ compiler is installed on Linux. If you have not installed it yet, follow the installation guide.

Create a source file

Create hello.ix:

#include <stdio.h>

int main() {
    printf("Hello from i++!\n");
    return 0;
}

i++ accepts C11 constructs such as #include, printf, and main. The .ix extension identifies an i++ source file.

Start with a small C11 program. Add i++ types and the iodine library when you need them.

Compile and run

Compile the source into an executable:

hypotenuse -c hello.ix

The current installation names the compiler executable hypotenuse; that name will change to j++. The compiler writes the program as hello in the current directory. Run it:

./hello

The program prints:

Hello from i++!

Without -c, the compiler emits generated C instead of building an executable:

hypotenuse hello.ix

Use the iodine library

The iodine library provides utilities such as printd. Install the printd.ih library, then import and expose the function:

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

int main() {
    printd("Hello, %s!", "i++");
    printd("The answer is %d.", 42);
    return 0;
}

printd accepts a C-style format string and optional values. It appends a newline after each call:

printd("value: %d", 42);

printfs interpolation is not available. Use printd with C-style format specifiers such as %s and %d.

See the standard library guide for available modules and import syntax.

Explore next

Syntax

Learn about imports, variables, functions, and control flow.

CLI reference

Explore compiler flags and debugging options.