Len trait

Len trait for collections. You may freely use and modify this code under the CC0 1.0 Universal License.

Usage

To use in your own project, just add the below to your Cargo.toml file.

[dependencies]
len-trait = "0.6"

For more formal documentation, you can find the rustdoc here.

lib.rs:

This crate generalises traits over the len and capacity methods found in most collections.

Methods that are included:

• capacity
• clear
• is_empty
• len
• reserve_exact
• reserve
• shrink_to_fit
• split_at_mut
• split_at
• split_off
• truncate
• with_capacity

Additionally, the traits IndexRange<Idx> and IndexRangeMut<Idx> are provided for "consistent slicing," i.e. slicing over all range types.

Modules

The len module provides:

• LenMut, which requires Clear
• Clear, which requires Len
• Len, which requires Empty
• Empty

The capacity module provides:

• CapacityMut, which requires WithCapacity
• WithCapacity, which requires Capacity
• Capacity, which requires Len.

The index module provides:

• IndexRange<Idx>, automatically implemented from Index<Idx>
• IndexRangeMut<Idx>, automatically implemented from IndexMut<Idx>
• SplitAt<Idx>, which requires IndexRange<Idx>
• SplitAtMut<Idx>, which requires IndexRangeMut<Idx>

Features

The alloc and std features offer different tiers of implementations for different collections. The std feature automatically enables alloc. Although the std feature is the default, disabling it will enable no_std.