Advanced containers for D
To use this package, run the following command in your project's root directory:
Put the following dependency into your project's dependences section:
Advanced data containers for D.
Currently available containers
An array-backed data structure that enforces the elements stored within itself to be in order. This eliminates the need for frequent reordering if a regular array was used. Has optimizations to reduce the search and insertion times.
Has random access for indexing, elements can be only put into the list with the
alias cmp can be used both to set how the elements are compared and the way of ordering
Using as a sorted set
The template of the SortedList can disable duplicates, which will also enable certain functions, like removal by element.
Implements an AVL-tree backed associative array. Automatically rebalances itself after each insertion and removal, if imbalance is greater or equal than 2. The more elements the tree has, the better the optimization will be.
Accessing is done through keys, and accessing an n-th element needs some computation.
Tree traversal done through
opApplyReverse() functions, accessing elements in order when iterated with
alias less can be used to both set how the keys are compared and whether lesser or greater elements are on the left hand side.
Behavior is changed if E set to void, in that case keys will be the only way the TreeMap stores data, like a regular AVL-tree, or a treeset.
Implements a hashmap using TreeMap as a backend, and MurMurHash3/32 as the default hashing algorithm. Only can be used with hashing algorithms that can be compared similarly to an integer.
Implements a hashset, similarly to hashmap. Operation is done through set operators only, as it only stores the keys of the hashed elements. Only can be used with hashing algorithms that can be compared similarly to an integer.
Very similar to D's own associative array.
Differentiates keys by checking whether they're equal or not. Has worse access times than TreeMap, but doesn't need optimization.
Implements a hashmap, using LinkedMap as a backend, and MurMurHash3/128 as the default hashing algorithm. Can be used with more complex keys.
A list with pretty low insertion cost. Ideal for applications where frequent reordering is needed. Can work as a set too by setting
Implements a hashset, using LinkedList in set mode as a backend, and MurMurHash3/128 as the default hashing algorithm. Can be used with more complex keys. Operation is done through set operators only, as it only stores the keys of the hashed elements.
//I recommend using an alias to shorten the declaration of types. alias SortedIntList = SortedList!(int, "a < b", true); SortedIntList sil; sil.put(5); assert(sil.arrayOf == , sil.toString); sil.put(3); assert(sil.arrayOf == [5, 3], sil.toString); sil.put(7); assert(sil.arrayOf == [7, 5, 3], sil.toString); sil.put(-1); assert(sil.arrayOf == [7, 5, 3, -1], sil.toString); sil.remove(2); assert(sil.arrayOf == [7, 5, -1], sil.toString); sil.put(2); assert(sil.arrayOf == [7 ,5, 2, -1], sil.toString); //This will print out the numbers in order, beginning with the greatest foreach (int i ; sil) writeln(i);
The library has some standardized set operators, repurposing preexisting operators found in D.
alias IntSet = TreeMap!(int, void, true); alias SortedIntSet = SortedList!(int, "a < b", false); IntSet a = IntSet([5, 8, 9, 1]); SortedIntSet b = SortedIntSet([6, 8, 9, 3]); //Set operators work between different types of sets. //The LHS type will decide what the result type will be IntSet intr = a & b; SortedIntSet diff = b ^ a; //RHS range can be of a non-set type, e.g. an array IntSet uni = a | [6, 5, 4, -1];
- Foreach capabilities of many containers are provided through
opApplyoperators, which have a complicated relationship with attributes. A workaround was provided through string mixins and CTFE trickery, but it looks janky. I'll try to talk with the D community about possible solutions.
- Registered by László Szerémi
- 0.3.2 released 2 days ago
- Copyright © 2020, laszl