docs(readme): updated readme to explain features and setup for library

This commit is contained in:
Mineplay 2025-04-19 07:04:33 -05:00
parent 693fa06e81
commit e6e433102a

View file

@ -1,3 +1,63 @@
# Hallocy # Hallocy
An advanced allocator library for C. An advanced allocator library for C.
## Introduction
Hallocy is an advanced C allocator library. This library implements the standard malloc, calloc, realloc, free, memset, memcopy, memmove and memcmp functions. The aim of this library is to be a better version of the standard C allocator by improving performance. Hallocy supports both Windows and Linux also keeping multithreading in mind.
## Features
The hallocy library offers the following features:
- Allocating and freeing memory
- Zeroing memory on allocation
- Reallocating memory
- Copying and moving memory
- Setting memory
- Comparing memory
## Installation
### Prerequisites
Ensure you have the following installed on your system:
* CMake (minimum version 3.10)
* A compatible C compiler (e.g., GCC or MSVC)
### Build Steps
1. Clone the repository:
```bash
git clone https://repo.strawhats.nl/Mineplay/Hallocy.git
```
2. Navigate to the directory:
```bash
cd Hallocy
```
3. Create build directory and navigate to it:
```bash
mkdir Build && cd Build
```
4. Run CMake to configure project:
```bash
cmake ..
```
5. Build the project:
```bash
cmake --build . --config Release
```
To build in debug use:
```bash
cmake --build .
```
This will both generate the library and test files.
## Using the library
The library file can be found in the `./Build/Release` folder as Hallocy.lib for windows and in `./Build` folder as libHallocy.a for linux. To use the library file you will need to copy the Hallocy folder containing the header files and follow the setup process for a library in the build system you are using.