A lightweight, dependency-free C library providing a consistent interface for file operations across different operating systems. The library abstracts platform-specific details and offers a unified API for reading, writing, and manipulating files

Features

Cross-platform compatibility (Linux, macOS, Windows, POSIX systems)
Multiple file modes (read, write, read/write, append, truncate, create, existence checking)
Flexible seeking (relative, absolute, end-based positioning)
Comprehensive error handling with detailed error codes
File metadata retrieval (size, current position, flags)
Peek functionality (read data without advancing the file pointer)
Buffering and flushing (control data persistence)
EOF detection and error clearing

Usage Example

#include "CgeFile.h"
#include <stdio.h>
#include <string.h>

int main(void) {
    int result;
    CgeFile *file = CgeFileNew("example.txt", CGE_FILE_READWRITE | CGE_FILE_CREATE, &result);
    if (!file) {
        fprintf(stderr, "Failed to open file: error code %d\n", result);
        return 1;
    }

    const char *data = "Hello, CgeFile!";
    size_t written;
    if (!CgeFileWrite(file, data, strlen(data), &written)) {
        fprintf(stderr, "Write failed\n");
        CgeFileFree(file);
        return 1;
    }

    char buffer[100];
    size_t actual;
    if (CgeFileSeek(file, 0, CGE_FILE_SET) &&
        CgeFileRead(file, buffer, sizeof(buffer) - 1, &actual)) {
        buffer[actual] = '\0';
        printf("Read: %s\n", buffer);
    }

    CgeFileFree(file);
    return 0;
}

Build Systems

CMake: supports Linux, macOS, Windows (MSVC, MinGW)
Makefile.posix: for GCC/Clang on POSIX systems
Makefile.mingw: for MinGW on Windows
Makefile.win32: for MSVC with NMake

Builds a static library. No shared library or external dependencies

Portability

Standard compliance: written in C89 + stdint.h
No dynamic memory allocation: all memory management is explicit
No external dependencies: relies only on standard C libraries

License

0BSD - a permissive license with no attribution required.