From db2fe5f45df7d5d85f02765ec0d3772940122277 Mon Sep 17 00:00:00 2001
From: Brendan Hansen <brendan.f.hansen@gmail.com>
Date: Fri, 15 May 2020 12:42:48 -0500
Subject: [PATCH] Added custom allocators (heap and nofree allocators) #8 #9

---
 bh.h      | 422 +++++++++++++++++++++++++++++++++++++++++++++++++-----
 onyx      | Bin 43368 -> 50520 bytes
 onyx.c    |   8 +-
 onyxlex.c |   4 +-
 onyxlex.h |   2 +-
 5 files changed, 397 insertions(+), 39 deletions(-)

diff --git a/bh.h b/bh.h
index 2af69298..54a2f382 100644
--- a/bh.h
+++ b/bh.h
@@ -28,6 +28,14 @@ typedef unsigned long isize;
 typedef i32 b32;
 typedef void* ptr;
 
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // Better debug functions
 //-------------------------------------------------------------------------------------
@@ -45,6 +53,12 @@ void* bh__debug_malloc(size_t size, const char* file, u64 line) {
 	return p;
 }
 
+void* bh__debug_aligned_alloc(size_t size, size_t alignment, const char* file, u64 line) {
+	void* p = aligned_alloc(size, alignment);
+	printf("[DEBUG] %p = aligned_alloc(%ld, %ld) at %s:%ld\n", p, alignment, size, file, line);
+	return p;
+}
+
 void bh__debug_free(void* ptr, const char* file, u64 line) {
 	printf("[DEBUG] free(%p) at %s:%ld\n", ptr, file, line);
 	free(ptr);
@@ -58,12 +72,23 @@ void* bh__debug_realloc(void* ptr, size_t size, const char* file, u64 line) {
 
 #endif
 
-#define malloc(size)		(bh__debug_malloc(size, __FILE__, __LINE__))
-#define free(ptr)			(bh__debug_free(ptr, __FILE__, __LINE__))
-#define realloc(ptr, size)	(bh__debug_realloc(ptr, size, __FILE__, __LINE__))
+#define malloc(size)					(bh__debug_malloc(size, __FILE__, __LINE__))
+#define aligned_alloc(size, alignment)	(bh__debug_aligned_alloc(size, alignment, __FILE__, __LINE__))
+#define free(ptr)						(bh__debug_free(ptr, __FILE__, __LINE__))
+#define realloc(ptr, size)				(bh__debug_realloc(ptr, size, __FILE__, __LINE__))
 
 #endif
 
+
+
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // Better character functions
 //-------------------------------------------------------------------------------------
@@ -75,6 +100,12 @@ b32 char_in_range(const char lo, const char hi, const char a);
 char charset_contains(const char* charset, char ch);
 i64 chars_match(char* ptr1, char* ptr2);
 
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // Better math functions
 //-------------------------------------------------------------------------------------
@@ -83,6 +114,91 @@ i64 chars_match(char* ptr1, char* ptr2);
 #define bh_clamp(v, a, b)	(bh_min((b), bh_max((a), (v))))
 #define bh_abs(x)			((x) < 0 ? -(x) : (x))
 
+#define bh_pointer_add(ptr, amm)		((void *)((u8 *) ptr + amm))
+
+
+
+
+
+
+
+//-------------------------------------------------------------------------------------
+// Custom allocators
+//-------------------------------------------------------------------------------------
+
+typedef enum bh_allocator_actions {
+	bh_allocator_action_alloc,
+	bh_allocator_action_free,
+	bh_allocator_action_resize,
+} bh_allocator_actions;
+
+#define BH_ALLOCATOR_PROC(name) \
+ptr name(ptr data, bh_allocator_actions action, \
+		 isize size, isize alignment, \
+		 void* prev_memory, \
+		 u64 flags)
+
+typedef BH_ALLOCATOR_PROC(bh__allocator_proc); // NOTE: so bh__allocator_proc can be used instead of that type
+
+typedef struct bh_allocator {
+	bh__allocator_proc* proc; // Procedure that can handle bh_allocator_actions
+	ptr					data; // Pointer to the other data for the allocator
+} bh_allocator;
+
+typedef enum bh_allocator_flags {
+	bh_allocator_flag_clear = 1	// Sets all memory to be 0
+} bh_allocator_flags;
+
+ptr bh_alloc(bh_allocator a, isize size);
+ptr bh_alloc_aligned(bh_allocator a, isize size, isize alignment);
+ptr bh_resize(bh_allocator a, ptr data, isize new_size);
+ptr bh_resize_aligned(bh_allocator a, ptr data, isize new_size, isize alignment);
+void bh_free(bh_allocator a, ptr data);
+
+#define bh_alloc_item(allocator_, T)				(T *) bh_alloc(allocator_, sizeof(T))
+#define bh_alloc_araray(allocator_, T, n)			(T *) bh_alloc(allocator_, sizeof(T) * (n))
+
+// NOTE: This should get optimized out since alignment should be a power of two
+#define bh__align(x, alignment)						((((x) / alignment) + 1) * alignment)
+
+
+
+
+// HEAP ALLOCATOR
+// Essentially a wrapper for malloc, free and realloc
+bh_allocator bh_heap_allocator(void);
+BH_ALLOCATOR_PROC(bh_heap_allocator_proc);
+
+
+
+
+
+// NOFREE ALLOCATOR
+
+typedef struct bh_alloc_nofree {
+	ptr memory;
+	ptr next_allocation;
+	isize size, total_size; // in bytes
+} bh_alloc_nofree;
+
+BH_ALLOCATOR_PROC(bh_alloc_nofree_allocator_proc);
+void bh_alloc_nofree_init(bh_alloc_nofree* alloc, isize total_size);
+void bh_alloc_nofree_free(bh_alloc_nofree* alloc);
+bh_allocator bh_alloc_nofree_allocator(bh_alloc_nofree* alloc);
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // Better strings
 //-------------------------------------------------------------------------------------
@@ -139,6 +255,14 @@ void bh_string_print(bh_string* str);
 #endif
 
 
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // Better files
 //-------------------------------------------------------------------------------------
@@ -178,7 +302,7 @@ typedef enum bh_file_standard {
 } bh_file_standard;
 
 typedef struct bh_file_contents {
-	// This will hold the allocator as well
+	bh_allocator allocator;
 	isize length;
 	void* data;
 } bh_file_contents;
@@ -200,23 +324,33 @@ i32 bh_file_read(bh_file* file, void* buffer, isize buff_size);
 i32 bh_file_write(bh_file* file, void* buffer, isize buff_size);
 i64 bh_file_size(bh_file* file);
 
-#define bh_file_read_contents(x) _Generic((x), \
+#define bh_file_read_contents(allocator_, x) _Generic((x), \
 	bh_file*: bh_file_read_contents_bh_file, \
 	const char*: bh_file_read_contents_direct, \
-	char*: bh_file_read_contents_direct)(x)
+	char*: bh_file_read_contents_direct)((allocator_), x)
 
-bh_file_contents bh_file_read_contents_bh_file(bh_file* file);
-bh_file_contents bh_file_read_contents_direct(const char* filename);
+bh_file_contents bh_file_read_contents_bh_file(bh_allocator alloc, bh_file* file);
+bh_file_contents bh_file_read_contents_direct(bh_allocator alloc, const char* filename);
 i32 bh_file_contents_delete(bh_file_contents* contents);
 
 #endif
 
+
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // Better dynamically-sized arrays
 //-------------------------------------------------------------------------------------
 #ifndef BH_NO_ARRAY
 
 typedef struct bh__arr {
+	bh_allocator allocator;
 	i32 length, capacity;
 } bh__arr;
 
@@ -227,6 +361,7 @@ typedef struct bh__arr {
 #define bh_arr(T)					T*
 #define bh__arrhead(arr)			(((bh__arr *)(arr)) - 1)
 
+#define bh_arr_allocator(arr)		(arr ? bh__arrhead(arr)->allocator : bh_heap_allocator())
 #define bh_arr_length(arr) 			(arr ? bh__arrhead(arr)->length : 0)
 #define bh_arr_capacity(arr) 		(arr ? bh__arrhead(arr)->capacity : 0)
 #define bh_arr_size(arr)			(arr ? bh__arrhead(arr)->capacity * sizeof(*(arr)) : 0)
@@ -236,9 +371,9 @@ typedef struct bh__arr {
 #define bh_arr_last(arr)			((arr)[bh__arrhead(arr)->length - 1])
 #define bh_arr_end(arr, i)			((i) >= &(arr)[bh_arr_length(arr)])
 
-#define bh_arr_new(arr, cap)		(bh__arr_grow((void**) &arr, sizeof(*(arr)), cap))
-#define bh_arr_free(arr)			(bh__arr_free((void**) &(arr)))
-#define bh_arr_copy(arr)			(bh__arr_copy((arr), sizeof(*(arr))))
+#define bh_arr_new(allocator_, arr, cap)	(bh__arr_grow((allocator_), (void**) &arr, sizeof(*(arr)), cap))
+#define bh_arr_free(arr)					(bh__arr_free((void**) &(arr)))
+#define bh_arr_copy(allocator_, arr)		(bh__arr_copy((allocator_), (arr), sizeof(*(arr))))
 
 #define bh_arr_grow(arr, cap) 		(bh__arr_grow((void **) &(arr), sizeof(*(arr)), cap))
 #define bh_arr_shrink(arr, cap)		(bh__arr_shrink((void **) &(arr), sizeof(*(arr)), cap))
@@ -253,7 +388,7 @@ typedef struct bh__arr {
 	bh__arrhead(arr)->length += n)
 
 #define bh_arr_push(arr, value) 	( \
-	bh__arr_grow((void **) &(arr), sizeof(*(arr)), bh_arr_length(arr) + 1), \
+	bh__arr_grow(bh_arr_allocator(arr), (void **) &(arr), sizeof(*(arr)), bh_arr_length(arr) + 1), \
 	arr[bh__arrhead(arr)->length++] = value)
 
 #define bh_arr_is_empty(arr)		(arr ? bh__arrhead(arr)->length == 0 : 1)
@@ -262,15 +397,26 @@ typedef struct bh__arr {
 #define bh_arr_deleten(arr, i, n)	(bh__arr_deleten((void **) &(arr), sizeof(*(arr)), i, n))
 #define bh_arr_fastdelete(arr, i)	(arr[i] = arr[--bh__arrhead(arr)->length])
 
-b32 bh__arr_grow(void** arr, i32 elemsize, i32 cap);
+b32 bh__arr_grow(bh_allocator alloc, void** arr, i32 elemsize, i32 cap);
 b32 bh__arr_shrink(void** arr, i32 elemsize, i32 cap);
 b32 bh__arr_free(void **arr);
-void* bh__arr_copy(void *arr, i32 elemsize);
+void* bh__arr_copy(bh_allocator alloc, void *arr, i32 elemsize);
 void bh__arr_insertn(void **arr, i32 elemsize, i32 index, i32 numelems);
 void bh__arr_deleten(void **arr, i32 elemsize, i32 index, i32 numelems);
 
 #endif
 
+
+
+
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // HASH TABLE FUNCTIONS
 //-------------------------------------------------------------------------------------
@@ -345,6 +491,44 @@ b32 bh_hash_iter_next(bh_hash_iterator* it);
 #undef BH_DEFINE
 
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // IMPLEMENTATIONS
 //-------------------------------------------------------------------------------------
@@ -387,8 +571,146 @@ i64 chars_match(char* ptr1, char* ptr2) {
 	return *ptr2 == '\0' ? len : 0;
 }
 
+
+
+
+
+
+
+//-------------------------------------------------------------------------------------
+// CUSTOM ALLOCATORS IMPLEMENTATION 
+//-------------------------------------------------------------------------------------
+
+
+ptr bh_alloc(bh_allocator a, isize size) {
+	return bh_alloc_aligned(a, size, 16);
+}
+
+ptr bh_alloc_aligned(bh_allocator a, isize size, isize alignment) {
+	return a.proc(a.data, bh_allocator_action_alloc, size, alignment, NULL,  0);
+}
+
+ptr bh_resize(bh_allocator a, ptr data, isize new_size) {
+	return bh_resize_aligned(a, data, new_size, 16);
+}
+
+ptr bh_resize_aligned(bh_allocator a, ptr data, isize new_size, isize alignment) {
+	return a.proc(a.data, bh_allocator_action_resize, new_size, alignment, data, 0);
+}
+
+void bh_free(bh_allocator a, ptr data) {
+	if (data != NULL) a.proc(a.data, bh_allocator_action_free, 0, 0, data, 0);
+}
+
+
+
+// HEAP ALLOCATOR IMPLEMENTATION
+
+bh_allocator bh_heap_allocator(void) {
+	return (bh_allocator) {
+		.proc = bh_heap_allocator_proc,
+		.data = NULL
+	};
+}
+
+BH_ALLOCATOR_PROC(bh_heap_allocator_proc) {
+	ptr retval = NULL;
+
+	switch (action) {
+	case bh_allocator_action_alloc: {
+		retval = aligned_alloc(alignment, size);
+
+		if (flags & bh_allocator_flag_clear && retval != NULL) {
+			memset(retval, 0, size);
+		}
+	} break;
+
+	case bh_allocator_action_resize: {
+		// TODO: Maybe replace with better custom function
+		retval = realloc(prev_memory, size);
+	} break;
+
+	case bh_allocator_action_free: {
+		free(prev_memory);
+	} break;
+	}
+
+	return retval;
+}
+
+
+
+
+
+
+
+// NOFREE ALLOCATOR IMPLEMENTATION
+
+BH_ALLOCATOR_PROC(bh_alloc_nofree_allocator_proc) {
+	bh_alloc_nofree* alloc_nf = (bh_alloc_nofree*) data;
+
+	ptr retval = NULL;
+
+	switch (action) {
+	case bh_allocator_action_alloc: {
+		size = bh__align(size, alignment);
+
+		retval = alloc_nf->next_allocation;
+
+		alloc_nf->next_allocation = bh_pointer_add(alloc_nf->next_allocation, size);
+		alloc_nf->size += size;
+		if (alloc_nf->size > alloc_nf->total_size) {
+			// Out of memory
+			fprintf(stderr, "NoFree allocator out of memory\n");
+			return NULL;
+		}
+	} break;
+
+	case bh_allocator_action_resize: {
+		// Need to think about this one
+	} break;
+
+	case bh_allocator_action_free: {
+		// Do nothing since this allocator isn't made for freeing memory
+	} break;
+	}
+
+	return retval;
+}
+
+void bh_alloc_nofree_init(bh_alloc_nofree* alloc, isize total_size) {
+	ptr data = malloc(total_size);
+
+	alloc->total_size = total_size;
+	alloc->size = 0;
+	alloc->memory = data;
+	alloc->next_allocation = data;
+}
+
+void bh_alloc_nofree_free(bh_alloc_nofree* alloc) {
+	free(alloc->memory);
+	alloc->memory = NULL;
+	alloc->next_allocation = NULL;
+	alloc->total_size = 0;
+	alloc->size = 0;
+}
+
+bh_allocator bh_alloc_nofree_allocator(bh_alloc_nofree* alloc) {
+	return (bh_allocator) {
+		.proc = bh_alloc_nofree_allocator_proc,
+		.data = alloc,
+	};
+}
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
-// STRING IMPLEMENTATION
+// STRING IMPLEMENTATION (BROKEN)
 //-------------------------------------------------------------------------------------
 #ifndef BH_NO_STRING
 
@@ -521,6 +843,14 @@ void bh_string_print(bh_string* str) {
 
 #endif // ifndef BH_NO_STRING
 
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // FILE IMPLEMENTATION
 //-------------------------------------------------------------------------------------
@@ -675,13 +1005,16 @@ i64 bh_file_size(bh_file* file) {
 	return size;
 }
 
-bh_file_contents bh_file_read_contents_bh_file(bh_file* file) {
-	bh_file_contents fc = { .length = 0, .data = NULL };
+bh_file_contents bh_file_read_contents_bh_file(bh_allocator alloc, bh_file* file) {
+	bh_file_contents fc = {
+		.allocator = alloc,
+		.length = 0, .data = NULL
+	};
 
 	isize size = bh_file_size(file);
 	if (size <= 0) return fc;
 
-	fc.data = malloc(size + 1);
+	fc.data = bh_alloc(alloc, size + 1);
 	fc.length = size;
 	bh_file_read_at(file, 0, fc.data, fc.length, NULL);
 	((u8*) fc.data)[fc.length] = '\0';
@@ -689,36 +1022,46 @@ bh_file_contents bh_file_read_contents_bh_file(bh_file* file) {
 	return fc;
 }
 
-bh_file_contents bh_file_read_contents_direct(const char* filename) {
+bh_file_contents bh_file_read_contents_direct(bh_allocator alloc, const char* filename) {
 	bh_file file;
 	bh_file_open(&file, filename);
-	bh_file_contents fc = bh_file_read_contents(&file);
+	bh_file_contents fc = bh_file_read_contents(alloc, &file);
 	bh_file_close(&file);
 	return fc;
 }
 
 b32 bh_file_contents_delete(bh_file_contents* contents) {
-	free(contents->data);
+	bh_free(contents->allocator, contents->data);
 	contents->length = 0;
 	return 1;
 }
 
 #endif // ifndef BH_NO_FILE
 
+
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // ARRAY IMPLEMENTATION
 //-------------------------------------------------------------------------------------
 #ifndef BH_NO_ARRAY
 
-b32 bh__arr_grow(void** arr, i32 elemsize, i32 cap) {
+b32 bh__arr_grow(bh_allocator alloc, void** arr, i32 elemsize, i32 cap) {
 	bh__arr* arrptr;
 
 	if (*arr == NULL) {
 		if (cap == 0 && elemsize == 0) return 1;
 
-		arrptr = (bh__arr *) malloc(sizeof(*arrptr) + elemsize * cap);
+		arrptr = (bh__arr *) bh_alloc(alloc, sizeof(*arrptr) + elemsize * cap);
 		if (arrptr == NULL) return 0;
 
+		arrptr->allocator = alloc;
 		arrptr->capacity = cap;
 		arrptr->length = 0;
 
@@ -730,7 +1073,7 @@ b32 bh__arr_grow(void** arr, i32 elemsize, i32 cap) {
 			i32 newcap = arrptr->capacity;
 			while (newcap < cap) newcap = BH_ARR_GROW_FORMULA(newcap);
 
-			p = realloc(arrptr, sizeof(*arrptr) + elemsize * newcap);
+			p = bh_resize(arrptr->allocator, arrptr, sizeof(*arrptr) + elemsize * newcap);
 
 			if (p) {
 				arrptr = (bh__arr *) p;
@@ -752,7 +1095,7 @@ b32 bh__arr_shrink(void** arr, i32 elemsize, i32 cap) {
 	cap = bh_max(cap, arrptr->length);
 
 	if (arrptr->capacity > cap) {
-		void* p = realloc(arrptr, sizeof(*arrptr) + elemsize * cap);
+		void* p = bh_resize(arrptr->allocator, arrptr, sizeof(*arrptr) + elemsize * cap);
 
 		if (p) {
 			arrptr = (bh__arr *) p;
@@ -768,17 +1111,17 @@ b32 bh__arr_shrink(void** arr, i32 elemsize, i32 cap) {
 
 b32 bh__arr_free(void **arr) {
 	bh__arr* arrptr = bh__arrhead(*arr);
-	free(arrptr);
+	bh_free(arrptr->allocator, arrptr);
 	*arr = NULL;
 }
 
-void* bh__arr_copy(void *arr, i32 elemsize) {
+void* bh__arr_copy(bh_allocator alloc, void *arr, i32 elemsize) {
 	bh__arr* arrptr = bh__arrhead(arr);
 
 	const i32 cap = arrptr->length;
 
 	void* newarr = NULL;
-	bh__arr_grow(&newarr, elemsize, cap);
+	bh__arr_grow(alloc, &newarr, elemsize, cap);
 	bh__arrhead(newarr)->length = cap;
 	bh__arrhead(newarr)->capacity = cap;
 	memcpy(newarr, arr, elemsize * arrptr->length);
@@ -800,15 +1143,14 @@ void bh__arr_deleten(void **arr, i32 elemsize, i32 index, i32 numelems) {
 }
 
 void bh__arr_insertn(void **arr, i32 elemsize, i32 index, i32 numelems) {
-	bh__arr* arrptr = bh__arrhead(*arr);
-
 	if (numelems) {
 		if (*arr == NULL) {
-			bh__arr_grow(arr, elemsize, numelems); // Making a new array
+			bh__arr_grow(bh_arr_allocator(arr), arr, elemsize, numelems); // Making a new array
 			return;
 		}
 
-		if (!bh__arr_grow(arr, elemsize, arrptr->length + numelems)) return; // Fail case
+		bh__arr* arrptr = bh__arrhead(*arr);
+		if (!bh__arr_grow(bh_arr_allocator(arr), arr, elemsize, arrptr->length + numelems)) return; // Fail case
 		memmove(
 			(char *)(*arr) + elemsize * (index + numelems),
 			(char *)(*arr) + elemsize * index,
@@ -819,6 +1161,20 @@ void bh__arr_insertn(void **arr, i32 elemsize, i32 index, i32 numelems) {
 
 #endif // ifndef BH_NO_ARRAY
 
+
+
+
+
+
+
+
+
+
+
+
+
+
+
 //-------------------------------------------------------------------------------------
 // HASHTABLE IMPLEMENTATION
 //-------------------------------------------------------------------------------------
@@ -863,7 +1219,7 @@ ptr bh__hash_put(ptr *table, i32 elemsize, char *key) {
 	// Didn't find it in the array, make a new one
 	arrptr = table[index];
 	len = bh_arr_length(arrptr);
-	bh__arr_grow(&arrptr, elemsize, len + 1);
+	bh__arr_grow(bh_arr_allocator(arrptr), &arrptr, elemsize, len + 1);
 	bh__arrhead(arrptr)->length++;
 	table[index] = arrptr;
 
diff --git a/onyx b/onyx
index 70fbd91f40f2f08e39891923682c6b1b47aeaf63..57bbd0546305f1b2277e9eb07e1b08de762d515f 100755
GIT binary patch
literal 50520
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
C0>1VD

literal 43368
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
a9amsvy^?SkGO_p{d6-jNZDFt!mH!Ko3k56y

diff --git a/onyx.c b/onyx.c
index ebb03052..7b718f2c 100644
--- a/onyx.c
+++ b/onyx.c
@@ -1,5 +1,5 @@
 #define BH_NO_STRING
-// #define BH_DEBUG
+#define BH_DEBUG
 #define BH_DEFINE
 #include "bh.h"
 
@@ -15,12 +15,14 @@ int main(int argc, char *argv[]) {
 		return EXIT_FAILURE;
 	}
 
-	bh_file_contents fc = bh_file_read_contents(&source_file);
+	bh_allocator alloc = bh_heap_allocator();
+
+	bh_file_contents fc = bh_file_read_contents(alloc, &source_file);
 	bh_file_close(&source_file);
 
 	bh_hash(u16) symbol_count;
 	bh_hash_init(symbol_count);
-	bh_arr(OnyxToken) token_arr = onyx_parse_tokens(&fc, symbol_count);
+	bh_arr(OnyxToken) token_arr = onyx_parse_tokens(alloc, &fc, symbol_count);
 
 	printf("There are %d tokens (Allocated space for %d tokens)\n", bh_arr_length(token_arr), bh_arr_capacity(token_arr));
 
diff --git a/onyxlex.c b/onyxlex.c
index 91224a03..8447be00 100644
--- a/onyxlex.c
+++ b/onyxlex.c
@@ -236,7 +236,7 @@ token_parsed:
 	return tk;
 }
 
-bh_arr(OnyxToken) onyx_parse_tokens(bh_file_contents *fc, bh_hash(u16) symcount) {
+bh_arr(OnyxToken) onyx_parse_tokens(bh_allocator tk_alloc, bh_file_contents *fc, bh_hash(u16) symcount) {
 	OnyxTokenizer tknizer = {
 		.start 			= fc->data,
 		.curr 			= fc->data,
@@ -247,7 +247,7 @@ bh_arr(OnyxToken) onyx_parse_tokens(bh_file_contents *fc, bh_hash(u16) symcount)
 	};
 
 	bh_arr(OnyxToken) token_arr = NULL;
-	bh_arr_grow(token_arr, 512);
+	bh_arr_new(tk_alloc, token_arr, 512);
 
 	OnyxToken tk;
 	do {
diff --git a/onyxlex.h b/onyxlex.h
index fe6b729d..1e4d287b 100644
--- a/onyxlex.h
+++ b/onyxlex.h
@@ -75,6 +75,6 @@ typedef struct OnyxToken {
 
 const char* onyx_get_token_type_name(OnyxToken tkn);
 OnyxToken onyx_get_token(OnyxTokenizer* tokenizer);
-bh_arr(OnyxToken) onyx_parse_tokens(bh_file_contents *fc, bh_hash(u16) symcount);
+bh_arr(OnyxToken) onyx_parse_tokens(bh_allocator tk_alloc, bh_file_contents *fc, bh_hash(u16) symcount);
 
 #endif
\ No newline at end of file
-- 
2.25.1