#vec #array #container #vector #stack

nightly staticvec

Implements a fixed-capacity stack-allocated Vec alternative backed by an array, using const generics

14 releases

✓ Uses Rust 2018 edition

new 0.3.4 Aug 18, 2019
0.3.3 Aug 15, 2019
0.2.80 Aug 10, 2019
0.1.11 Aug 2, 2019
0.1.6 Jul 31, 2019

#122 in Data structures

Download history 121/week @ 2019-07-27 211/week @ 2019-08-03 220/week @ 2019-08-10

184 downloads per month

MIT/Apache

74KB
2K SLoC

Latest Version Rustc Version nightly

Implements a fixed-capacity stack-allocated Vec alternative backed by an array, using const generics.

Note: the word "static" here is meant by the traditional definition of "unchanging" / "not dynamic" etc.

This crate does not use literal static variables for anything.

Fully #![no_std] compatible (with almost no loss of functionality) by setting default-features = false for the staticvec dependency in your Cargo.toml.

Optional support for serialization and deserialization of the StaticVec struct via serde is available by activating the serde_support feature.

Contributions/suggestions/etc. very welcome!

Minimum supported Rust version: due to the use of const generics, this is a nightly-only crate at the moment.

Known issues: Incremental linking is, currently, an acknowledged cause of "internal compiler errors" when used in conjunction with const generics. If you encounter any while trying to use this crate, there's a relatively good chance they can be worked around by setting incremental = false for the relevant build profile in your Cargo.toml.

A basic usage example:

use staticvec::*;

fn main() {
  let mut v = StaticVec::<i32, 64>::new();
  for i in 0..v.capacity() {
    v.push(i as i32);
  }
  for i in &v {
    println!("{}", i);
  }
  v.clear();
  v.insert(0, 47);
  v.insert(1, 48);
  v.insert(2, 49);
  v.insert(v.len() - 1, 50);
  v.insert(v.len() - 2, 51);
  v.insert(v.len() - 3, 52);
  for i in &v {
    println!("{}", i);
  }
  for i in &v.reversed().drain(2..4) {
    println!("{}", i);
  }
  while v.is_not_empty() {
    println!("{}", v.remove(0));
  }
  for f in staticvec![12.0, 14.0, 15.0, 16.0].iter().skip(2) {
    println!("{}", f);
  }
  for v in &staticvec![
    staticvec![12.0, 14.0],
    staticvec![16.0, 18.0],
    staticvec![20.0, 22.0],
    staticvec![24.0, 26.0]
  ] {
    for f in v.iter().skip(1) {
      println!("{}", f);
    }
  }
}

License:

Licensed under either the MIT license or version 2.0 of the Apache License. Your choice as to which! Any source code contributions will be dual-licensed in the same fashion.

Dependencies

~0–305KB