thepigeongenerator/mcaselector-lite
1
0
Fork 0
mirror of https://github.com/thepigeongenerator/mcaselector-lite.git synced 2025-12-17 07:55:45 +01:00
Code Issues Packages Projects Releases Wiki Activity

update comments and a parameter name in mcx.h

Browse Source
This commit is contained in:
Quinn
2025-08-27 14:57:34 +02:00
parent 7531d786be
commit bc8803525d
1 changed files with 14 additions and 5 deletions
Download Patch File Download Diff File Expand all files Collapse all files

19
src/dat/mcx.h
View File

@@ -14,14 +14,23 @@ struct mcx_chunk {
u32 time; // modification time in epoch seconds u32 time; // modification time in epoch seconds
}; };
/* Deletes chunk `idx` from `buf`, moving all chunks downwards in the process. */ /* Deletes a single chunk (`chunk`) out of `buf`.
size_t mcx_delchunk(u8 *restrict buf, int idx) NONNULL((1)); * 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. */
size_t mcx_delchunk(u8 *restrict buf, int chunk) NONNULL((1));
/* Deletes a range of chunks from index `start` to `end`. */ /* 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 */
size_t mcx_delchunk_range(u8 *restrict buf, int start, int end) NONNULL((1)); size_t mcx_delchunk_range(u8 *restrict buf, int start, int end) NONNULL((1));
/* Deletes `chunkc` chunks specified in `chunks` from the `*.mcX` file. /* Deletes a `chunkc` chunks from `chunks` out of `buf`.
* This is done in a way to perform minimal memmove operations. */ * 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 */
size_t mcx_delchunk_bulk(u8 *restrict buf, const u16 *restrict chunks, int chunkc) NONNULL((1, 2)); size_t 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. */ /* Computes the byte size of the `*.mcX` file in `buf` and returns it. */