28 releases

0.3.2 Oct 23, 2024
0.2.2 May 14, 2024
0.2.1 Jan 16, 2024
0.2.0 Apr 11, 2023
0.1.7 Oct 13, 2018

#21 in Rust patterns

Download history 183839/week @ 2024-12-21 216928/week @ 2024-12-28 313816/week @ 2025-01-04 369081/week @ 2025-01-11 323206/week @ 2025-01-18 341290/week @ 2025-01-25 377828/week @ 2025-02-01 490692/week @ 2025-02-08 514960/week @ 2025-02-15 569846/week @ 2025-02-22 598475/week @ 2025-03-01 594001/week @ 2025-03-08 608412/week @ 2025-03-15 564674/week @ 2025-03-22 551191/week @ 2025-03-29 554705/week @ 2025-04-05

2,379,960 downloads per month
Used in 3,473 crates (263 directly)

MIT/Apache

36KB
855 lines

smol_str

CI Crates.io API reference

A SmolStr is a string type that has the following properties:

  • size_of::<SmolStr>() == 24 (therefore == size_of::<String>() on 64 bit platforms)
  • Clone is O(1)
  • Strings are stack-allocated if they are:
    • Up to 23 bytes long
    • Longer than 23 bytes, but substrings of WS (see src/lib.rs). Such strings consist solely of consecutive newlines, followed by consecutive spaces
  • If a string does not satisfy the aforementioned conditions, it is heap-allocated
  • Additionally, a SmolStr can be explicitly created from a &'static str without allocation

Unlike String, however, SmolStr is immutable. The primary use case for SmolStr is a good enough default storage for tokens of typical programming languages. Strings consisting of a series of newlines, followed by a series of whitespace are a typical pattern in computer programs because of indentation. Note that a specialized interner might be a better solution for some use cases.

MSRV Policy

Minimal Supported Rust Version: latest stable.

Bumping MSRV is not considered a semver-breaking change.

Dependencies

~220KB