weakset 1.0.1
A set that doesn't prevent its contents from being collected by the garbage collector
To use this package, run the following command in your project's root directory:
Manual usage
Put the following dependency into your project's dependences section:
What's a weak set?
A weak set allows you to store a set of items in a container, while not keeping the those items explicitly alive. If all references to an item--other than those references from a weakset--are gone, then the garbage collector will collect the item, and the item will be removed from all weaksets that it's in.
Usage
// Creating a weak set:
WeakSet!Foo set = new WeakSet!Foo();
// Checking set membership:
bool isInTheSet = foo in set;
// Adding to/removing from the set:
set.add(foo);
set.remove(bar);
// Getting the number of items in the set:
writeln(set.length);
// Looping over the set:
foreach (item; set) {
writeln(item, " is in the set!");
}
// Complex "transactional" operations:
{
// set.lock() guarantees that the contents of the set will
// not change until the set is unlocked; in other words,
// the GC will track the contents of the set until the set
// is unlocked
set.lock();
scope (exit) set.unlock();
size_t len = set.length;
doStuff();
foreach (item; set) {
writeln(item, " is part of a set with length ", len);
}
}
- 1.0.1 released a year ago
- brianush1/weakset
- BSL-1.0
- Copyright © 2023, Brian
- Authors:
- Dependencies:
- none
- Versions:
-
1.0.1 2023-Apr-06 1.0.0 2023-Apr-06 ~master 2023-Apr-06 - Download Stats:
-
-
0 downloads today
-
0 downloads this week
-
2 downloads this month
-
54 downloads total
-
- Score:
- 0.5
- Short URL:
- weakset.dub.pm