README
NAME
Array::Sparse - role for sparsely populated Arrays
SYNOPSIS
use Array::Sparse;
my @a is Array::Sparse;DESCRIPTION
Exports an Array::Sparse role that can be used to indicate the implementation of an array (aka Positional) that will not allocate anything for indexes that are not used. It also allows indexes to be used that exceed the native integer size.
Since Array::Sparse is a role, you can also use it as a base for creating your own custom implementations of (sparse) arrays.
CAVEATS
If you populate more than 5% of the indexes you will be better off using a normal array for better performance. Unless memory is of the most importance.
Iterating Methods
Methods that iterate over the sparse array, will only report elements that actually exist. This affects methods such as .keys, .values, .pairs, .kv, .iterator, .head, .tail, etc.
SEE ALSO
If the numeric values of the sparse array do not exceed the native integer range, then the Hash::int may also be of interest.
AUTHOR
Elizabeth Mattijsen [email protected]
Source can be located at: https://github.com/lizmat/Array-Sparse . Comments and Pull Requests are welcome.
If you like this module, or what Iām doing more generally, committing to a small sponsorship would mean a great deal to me!
COPYRIGHT AND LICENSE
Copyright 2018, 2020, 2021, 2023, 2024, 2026 Elizabeth Mattijsen
This library is free software; you can redistribute it and/or modify it under the Artistic License 2.0.