docs(readme): updated readme to explain features and setup for library
This commit is contained in:
parent
693fa06e81
commit
e6e433102a
1 changed files with 61 additions and 1 deletions
62
README.md
62
README.md
|
|
@ -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.
|
||||||
Loading…
Add table
Reference in a new issue