diff options
| author | Mistivia <i@mistivia.com> | 2025-12-29 12:28:09 +0800 |
|---|---|---|
| committer | Mistivia <i@mistivia.com> | 2025-12-29 12:28:09 +0800 |
| commit | 26e201c55aff4c877d21c41d627576792b060f54 (patch) | |
| tree | 07394bdd71fe95d371e82e9867268d5beaee7d15 | |
| parent | 142f864091727fd1d7d7c77628e682398201d682 (diff) | |
| -rw-r--r-- | README.md | 29 |
1 files changed, 29 insertions, 0 deletions
@@ -18,3 +18,32 @@ ## Run Tests make test + +## Quickstart + +For example, if you have a custom type `FancyThing`, and you want a linked list of `FancyThing`s. Just add `LIST_DEF_AS(FancyThing, FancyThings)` to the header file, and `LIST_IMPL_AS(FancyThing, FancyThings)` to a source file, and you get a new type `FancyThings`, and many functions for free: + +- `FancyThings_create` +- `FancyThings_push_back` +- `FancyThings_push_front` +- `FancyThings_pop_back` +- `FancyThings_pop_front` +- `FancyThings_pop_front` +- ... + +And if you want a hash table with `FancyThing` as key, and a integer as value. First, define and implement 2 functions: + +- `uint64_t FancyThing_hash(FancyThing self)` +- `bool FancyThing_eq(FancyThing a, FancyThing b)` + +These functions just act like how typeclass/trait/concept works in Haskell/Rust/C++. And we provide `mmhash` to help you build `FancyThing_hash`. + +Then you can add `HASH_TABLE_DEF_AS(FancyThing, Int, FancyTable)` to the header file, and `HASH_TABLE_IMPL_AS(FancyThing, Int, FancyTable)` to a source file. Then you get a new type `FancyTable` and its functions: + +- `FancyTable_create` +- `FancyTable_free` +- `FancyTable_insert` +- `FancyTable_find` +- ... + +And other data structures follow similar patterns. |