mulle-rbtree

🍫 mulle-rbtree organizes data in a red/black tree

This is an implementation of a red-black tree. mulle-allocator is used to simplify memory management. It isn't thread-safe.

Release Version	Release Notes	AI Documentation
	RELEASENOTES	DeepWiki for mulle-rbtree

Info

Red-black trees are difficult to explain without lots of diagrams, so little attempt is made to document this code. However, an excellent discussion can be found in the following book, which was used as the reference for writing this implementation:

   Introduction to Algorithms
   Thomas H. Cormen, Charles E. Leiserson, and Ronald L. Rivest
   MIT Press (1990)
   ISBN 0-07-013143-0

Some functions use a comparison function pointer, which is expected to have the following prototype:

   int (compare *)( void *payload_a, void *payload_b);

Interpretation of comparison function return values:

Return value	Comparison
< 0	a_a < a_b
0	a_a == a_b
> 0	a_a > a_b

You are here

Quickstart

Install mulle-core developer then:

mulle-sde init -d my-project -m mulle-core/c-developer executable
cd my-project
mulle-sde vibecoding on
mulle-sde run

You are done, skip the following "Add" step.

Add

This project is a component of the mulle-core library. As such you usually will not add or install it individually, unless you specifically do not want to link against mulle-core.

Add as an individual component

Use mulle-sde to add mulle-rbtree to your project:

mulle-sde add github:mulle-c/mulle-rbtree

To only add the sources of mulle-rbtree with dependency sources use clib:

clib install --out src/mulle-c mulle-c/mulle-rbtree

Add -isystem src/mulle-c to your CFLAGS and compile all the sources that were downloaded with your project.

Install

Use mulle-sde to build and install mulle-rbtree and all dependencies:

mulle-sde install --prefix /usr/local \
   https://github.com/mulle-c/mulle-rbtree/archive/latest.tar.gz

Legacy Installation

Install the requirements:

Requirements	Description
mulle-storage

Download the latest tar or zip archive and unpack it.

Install mulle-rbtree into /usr/local with cmake:

PREFIX_DIR="/usr/local"
cmake -B build                               \
      -DMULLE_SDK_PATH="${PREFIX_DIR}"       \
      -DCMAKE_INSTALL_PREFIX="${PREFIX_DIR}" \
      -DCMAKE_PREFIX_PATH="${PREFIX_DIR}"    \
      -DCMAKE_BUILD_TYPE=Release &&
cmake --build build --config Release &&
cmake --install build --config Release

Author

Nat! for Mulle kybernetiK