Repository files navigation

z_

Core Language Module with datatypes, memory tracker, andmore.

This library provides Core Functionality built upon the C language. Inspired and taken from Modern Languages such as Python, Rust etc.

• Memory Management: Allocators, Memory Debugger.
• Types & Data Structures: Clean Systematic Data types and Structures with feature-full fuctionality.
• Meta-Programming: An absolute abuse of C-preprocessor.
• Utilities: Mini Libraries and modules for extendend fucntionality (e.g. TUI) and wrappers (e.g. curl, cglm)

List of sub-modules of provided by the library.

Meta-programming using C-preprocessor.Explore Source

Helper function for preprocessor macros, not used directly

Stuff that is probably needed everywhere.

z_ is made with modularity in mind so many parts of it are as self-isolated as they can,it doesn't even include standard library exceptstddef.h,stdint.h andstdbool.h for typedeclarationbut they still require the bare minimumbase for to be working properly suchas,z_/arr.h can be included in itself but it still requirebase.h oftypesforz__u32 andmem.h for memory allocation definitions.

Therefore, You need to explicitly include the<stdlib.h>,<string.h>.

Inorder to integratedz_ in your project only

git clone --depth=1 git://github.com/zakarouf/z_.gitsh build.sh lib

Will result a library libz_.a created in the./build/lib and headers at./build/include asz_ directory.

Copy thez_ folder onto yourinclude directory. And copy thelibz_.a to thelib directory and link it against the executable and we are good to go.

#include<z_/z_.h>

Run thebuild.sh script, with the following parameters

sh build.sh install lib

By Default, the path for Headers isusr/local/include/z_ and for library it islibz_.a, you can change it by editing thebuild.sh file itself,LIB_DIR andINCLUDE_DIR to be specfic.

Inside the source directoryconfig_{MODULE}.h that can be modified by the user in-order to change the behaviour, include, exclude the fuctionality of that sub-library.

{MODULE} is the name of the Module i.e. config_imp.h, config_prep.h etc.

Such as inside ofsrc/lib/_config_types.h

#defineZ___TYPE_CONFIG__USE_TYPE_LINKEDLIST

This particular config tells to include the Linked List type and its functionaity at core; whenz_.h is included, and if we comment out it

//#define Z___TYPE_CONFIG__USE_TYPE_LINKEDLIST

Will result in a errorThis forces to you to include linked list type manually.

#include<z_/types/llist.h>

Now this will work as it should.

z_ is now uses stb-style header impletation macro without compiling a.a library to link to.DefineZ__IMPLEMENTATION in any one of the source file before including the header.I would recommended creating a seperate empty source file with all the impletation defined.

#defineZ__IMPLEMENTATION#include<z_/time.h>

Additional syntax Highlighting for types and such are include in the extra/c.vim.

To add it into your project, either copy the contents of thec.vim file or putc.vim into yourafter/syntax folder, such as~/.config/vim/after/syntax/ directory.This will load on top of your syntax highlighting for every .c file.

• Documentation
• Overview

z_ had a humble beginning as a single header for defining primitive types inztorg project.
Later on I added more quality of life stuff such as Type-Generic Dyanmic Arrays etc. It was then I decided to move its development to a separate repo with more than just a "Data Type Library". I wanted to created a core, standard-library that I can just use anywhere as a starting point.

Linux and MacOS is fully supported while, with Windows your mileage might vary.

As for Compiler GCC or Clang is recommended.

Bloat. Creating such library that I can use anywhere, I wanted to have as less bloated binary wise as posible, while also having to combat the non-type generic nature of the C language.
If by any case, I dont want use a bare macro. I would wrap it up inside of a function.

#definemy_macro_function(a,b) { ... }voidmy_function(inta,intb){my_macro_function(a,b);}

Me. Or you if you stumble upon my stuff and found it cool. But as of writing, I created this for myself. This repo is so I can easily maintain and access the code and or share it with my friends.I am not a good Programmer by a long shot, I just like when my computer goes beep-boop.

It takes many features from other libraries and projects. Whilst also some Reffrences and books.

Hirrolot'sDatatype99. For my own implementation of Sum Types. The actual impletation is dis-similar to them. My implementation ofz__Enum is no where near as elegant as Datatype99.

Awesome C Preprocessor Helped to study on the C's magical Preprocessor.

Sum of an Integer Array

Intializing an Array of Functions in a single line

Sum of Binary tree using Enum

Web Event with Enums

Fill Up an array of Vector2 with OpenMP

Creating a Map with Pthread

• Awesome C Preprocessor
• Generic-Print
• P99
• Cloak
• Metatlang99
• Datatype99

This library is not perfect and I know there are many others like it, but this one is mine <3.