mirror of
https://github.com/thepigeongenerator/mcaselector-lite
synced 2026-02-08 07:33:35 +01:00
Quinn
f5784844a8
These headers have no associated C files, and are mainly used for utility logic. Having them in `/include` makes them more easily located, and more globally used. We are using "classic" header guards here over `#pragma once` for better support. Since `#pragma once` is defined by the compiler, rather than standard C. Why isn't it used across the project? I have no idea.
41 lines
1.8 KiB
C
41 lines
1.8 KiB
C
/* This file is part of MCA-Selector-lite,
|
|
* and is licensed under GPL-2.0-only.
|
|
* Copyright (C)2025 quinnthepigeon@proton.me Quinn
|
|
* For further information, view COPYING and CONTRIBUTORS
|
|
* at: www.github.com/thepigeongenerator/mcaselector-lite */
|
|
#pragma once
|
|
|
|
#include <mcaselector-lite/atrb.h>
|
|
#include <mcaselector-lite/types.h>
|
|
#include <stdlib.h>
|
|
|
|
|
|
/* contains chunk metadata */
|
|
struct mcx_chunk {
|
|
usize idx; // byte offset for start of chunk data
|
|
u32 len; // byte length of chunk (+ padding)
|
|
u32 time; // modification time in epoch seconds
|
|
};
|
|
|
|
/* Deletes a single chunk (`chunk`) out of `buf`.
|
|
* The chunk's location data shall become `0`, and timestamp data the current time.
|
|
* All succeeding chunks shall be moved back, freeing space.
|
|
* Returns the amount of bytes removed. */
|
|
usize mcx_delchunk(u8 *restrict buf, int chunk) NONNULL((1));
|
|
|
|
/* Deletes the range defined by `start`—`end` (inclusive) of chunks out of `buf`.
|
|
* The chunk's location data shall become `0`, and timestamp data the current time.
|
|
* All succeeding chunks shall be moved back, freeing space.
|
|
* Returns the amount of bytes removed */
|
|
usize mcx_delchunk_range(u8 *restrict buf, int start, int end) NONNULL((1));
|
|
|
|
/* Deletes a `chunkc` chunks from `chunks` out of `buf`.
|
|
* If the `chunks` indices are known to be sequential, i.e. have a constant difference of `1`, `mcx_delchunk_range` should be preferred.
|
|
* The chunk's location data shall become `0`, and timestamp data the current time.
|
|
* All succeeding chunks shall be moved back, freeing space.
|
|
* Returns the amount of bytes removed */
|
|
usize mcx_delchunk_bulk(u8 *restrict buf, const u16 *restrict chunks, int chunkc) NONNULL((1, 2));
|
|
|
|
/* Computes the byte size of the `*.mcX` file in `buf` and returns it. */
|
|
usize mcx_calcsize(const u8 *restrict buf) NONNULL((1)) PURE;
|