qstr 0.1.0

Cache-efficient, stack-allocated string types
Documentation

qstr

Crates.io Docs.rs Licence Build Status no_std Minimum Rust Version

qstr is a small, no_std Rust library providing cache-efficient, stack-allocated string types.

It is suitable for embedded environments, WebAssembly, parsers and other peformance-sensitive contexts.

Motivation

In many cases, string lengths are bounded and their maximum size is known in advance. Storing such strings on the stack eliminates allocator overhead and improves cache locality.

Because qstr types implement Copy, they can be passed by value without cloning.

This library provides types for common sizes, optimised for cache-line efficiency.

Features

  • Stack-allocated string types
    • Variable-length strings with fixed capacity
    • Fixed-length strings
    • Fixed-capacity string vectors
  • All types implement Copy
  • Usable in const contexts
  • Optional serde support
  • no_std compatible
  • Zero dependencies

Example

use qstr::BStr15;
use qstr::StrVec;

let str: BStr15 = "aws:us:east:1".into();
let vec: StrVec<u16, 15> = str.split(":");

assert_eq!(
  vec.iter().collect::<Vec<_>>(),
  vec!["aws", "us", "east", "1"]
);

Licence

qstr is licensed under the terms of the Apache License, Version 2.0.