aboutsummaryrefslogtreecommitdiff
path: root/lib/darr.h
blob: aa37d27a62e83e875738ec38a15ea1398804d129 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
/* Copyright (C) 2023 Aryadev Chavali

 * You may distribute and modify this code under the terms of the
 * GPLv2 license.  You should have received a copy of the GPLv2
 * license with this file.  If not, please write to:
 * aryadev@aryadevchavali.com.

 * Created: 2023-10-15
 * Author: Aryadev Chavali
 * Description: Dynamically sized byte array
 */

#ifndef DARR_H
#define DARR_H

#include <stdio.h>
#include <stdlib.h>

#include "./base.h"

/**
 * A dynamically sized buffer of bytes which may be used for a
 * variety of purposes.
 * @prop data: Buffer of bytes (may be reallocated)
 * @prop used: Number of bytes currently used
 * @prop available: Number of bytes currently allocated
 */
typedef struct
{
  byte *data;
  size_t used, available;
} darr_t;

/* Some useful constants for dynamic array work. */
#define DARR_DEFAULT_SIZE 8
#define DARR_REALLOC_MULT 1.5

/** Get the INDth item in a darr, where the buffer of bytes is
 * considerd an array of type TYPE.
 * Unsafe operation as safety checks are not done (in particular if
 * the dynamic array has IND items or is big enough to store an
 * element of TYPE) so it is presumed the caller will.
 */
#define DARR_AT(TYPE, DARR_DATA, IND) ((TYPE *)(DARR_DATA))[(IND)]

void darr_init(darr_t *, size_t);
void darr_ensure_capacity(darr_t *, size_t);
void darr_append_byte(darr_t *, byte);
void darr_append_bytes(darr_t *, byte *, size_t);
byte darr_at(darr_t *, size_t);

void darr_write_file(darr_t *, FILE *);
darr_t darr_read_file(FILE *);

#endif