Minilibs & Kollektions & Kallok & Smallstr

Really useful cross-platform C libraries.

(Tested on Linux and Windows)

If you are using the build.c build system, you can just add this as git submodule and add a task like this to your build file:

enum CompileResult target_deps() {
    ONLY_IF({
        CHANGED("allib/");
        NOT_FILE("allib/build/all.a");
    });
    START;
    ssx("allib/", "-DHAVE_WINSOCK=0", ({
        ss_task("all.a");
    }));
    END;
}

If you are making an executable, you also need to add DEP("allib/build/all.a") to a compile files list.

Otherwise, you need to first compile the independent build.c file. (The project uses build.c) But first you should configure some options that can be found in the top of the build.c file. Additional options that can be overwritten can be fond in the build_c/build.h files. Then run: ./build.exe to list all available tasks. (The output static-library (lib.a) be located in the build/ directory)

You can use TCC to compile on Windows. Define AR to tcc -ar and CC to tcc to do that. Example: tcc -DAR="\"tcc -ar\"" -DCC="\"tcc\"" build.c -o build.exe

Some components might use preprocessor macros like __AVX512BW__ to compile a different set of source files, so make sure to always compile build.c for the correct target. it is recommended to copy the CFLAGS you use for building build.c into the CC_ARGS macro.

Kollektions

• Fixed List: fixed-length mutable list. Is the base for most other collections.
• Dynamic List: dynamically-allocated mutable list.
• Doubly Linked List: dynamically-allocated mutable list with O(1) remove, add and insert
• Any List & Mutable Any List virtual interface for all lists

Best practices: annotate generic types with the TYPES() macro. Example: DynamicList TYPES(int)

germanstr

UmbraDB-like string implementation

• Fast C strings for modern processors
• Strings shorter than 12 bytes on 64 bit machines can be stored on the stack

TCP client

• Cross-platform simple TCP client

niglob

• glob() but with way more features
• pattern matching works on string lists too
• Cross-platform

Kallok

• Common interface for all allocators. Ally type.
• Page allocator
• LibC allocator
• Basic fixed & dynamic allocators: big allocation split into chunks. one allocation consists of multiple chunks.
• Disk-based allocator: virtual maps a file into memory.

Kash

• hash functions: fnv1a, pearson
• rijndael sbox

miniproc

Simple child process pipe IO library for C. Warning: this library is currently a bit broken!!

ChildProc proc = cpopen("/bin/echo", (const char *[]) { "Hi", NULL });
if (proc.from == NULL) {
    fprintf(stderr, "error: %i\n", errno);
    return 1;
}

while (cpalive(proc)) {
    copyNFile(stdout, proc.from, cpcountnext(proc));
}
copyNFile(stdout, proc.from, cpcountnext(proc));
cpclose(proc);

minitab

Simple string table printing library for C.

int main() {
    Table table;
    table.cols = 3;
    table.rows = 3;
    table_create(&table);

    table_color_col(table, ANSI_COLOR_RED, 0);

    table.colsExtraPad[1] = 2;
    table.colsPadLeft[1] = true;

    table_cell(table, 0, 0).text = "Test";

    table_put_fmt(table, 1, 0, "Test %i", 1);
    table_cell(table, 1, 0).color = ANSI_COLOR_GREEN;

    table_print(table, stdout);
    table_delete(&table);
}

miniconf

Simple configuration file parser for C.

int main() {
    Config cfg;
    config_init(&cfg);

    FILE *file = fopen("test.miniconf", "r");
    const AllocGroup file_alloc = config_add_file(&cfg, file);
    fclose(file);

    bool ok;
    const char *value = config_get_str_at(cfg, "status bar/normal/format", &ok);
    printf("%i: %s\n", ok, value);

    allocgroup_free(file_alloc);
    config_destroy(&cfg);

    return 0;
}

(If you want to get many variables in for example status bar/normal, you should use config_children and use the temporary result)

config:

status bar:
    visible: true
    scale: 0.4
    background: xFFFFFFFF
    normal:
        format: "{lang}  {line}/{col}
    input:
        has hint:
            format: "{hint}: {message}
        has not hint:
            format: "{message}

minifmt

Simple string templating library for C.

also provides:

• ascii_to_ll
• ascii_to_d
• ll_to_ascii
• d_to_ascii

static const char *fmt_str = "Test {row} str {col.h}";

int main(void) {
    const size_t len = strlen(fmt_str);
    char *str = malloc(len + 1);
    memcpy(str, fmt_str, len + 1);

    const Fmt fmt = fmt_compile(str);
    char *res = fmt_fmt_fmt(fmt, (PlaceholderList) {
        .elems = (Placeholder[]) {
            PLACEHOLDER_LONG("col", 11),
            PLACEHOLDER_LONG("row", 2)
        },
        .elems_size = 2
    });
    printf("%s\n", res);
    free(res);
    fmt_destroy(fmt);

    free(str);
    return 0;
}

filelib

• easy-to-use functions to read lines or the whole stream into memory
• functions for copying streams
• works on physical- as well as virtual files

memlib

• fast (benefit from vectorization) strided memcopy
• "strided memcopy" meaning copying between two arrays of different strides but same element sizes. this is useful for many things like gather & scatter with offsets and others.

typedef struct {
    float a;
    float b; 
} MyData;

void loadAs(MyData* dest, float * a, size_t count) {
    char* d = ((char*)dest) + offsetof(MyData, a);
    strided_memcpy(d, sizeof(MyData), 
                   a, sizeof(float),
                   count,
                   sizeof(float));
}

void loadBs(MyData* dest, float * b, size_t count) {
    char* d = ((char*)dest) + offsetof(MyData, b);
    strided_memcpy(d, sizeof(MyData), 
                   b, sizeof(float),
                   count,
                   sizeof(float));
}

mutex.h

• Cross-platform mutex

uthread.h

• Cross-platform threads library (WIN32 threads on Windows and otherwise pthreads)