CgeFile - File Access Library for C

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.