weak_collections 1.1.0 copy "weak_collections: ^1.1.0" to clipboard
weak_collections: ^1.1.0 copied to clipboard

Collection of soft references.

weak_collections #

This package contains the classes:

  • WeakMap
  • WeakSet

WeakMap #

A WeakMap allows you to garbage collect its keys, and remove references to values after keys are recycled. This means that when the key is recycled, the value will also be recycled.

Object? o = Object();
Object o2 = Object();
WeakMap weakMap = WeakMap();
weakMap[o] =o2;
o = null;

// After garbage collection weakMap[o] will be removed.
print(weakMap.length); // print 0  

WeakSet #

WeakSet will automatically free objects stored in unreferenced. This means that if an object has no other application, it will not exist in the WeakSet.

Object? o = Object();
WeakSet weakSet = WeakSet();
weakSet.add(o);
o = null;

// After garbage collection [o] will be removed.
print(weakSet.length); // print 0  

Usage #

See example for detailed test case.

Issues #

If you encounter issues, here are some tips for debug, if nothing helps report to issue tracker on GitHub: