Google Git
Sign in
fuchsia / third_party / github.com / rust-lang / rust-analyzer / 81c8790a175365d72040959f689abab5b4e93ca4
commit81c8790a175365d72040959f689abab5b4e93ca4[log] [tgz]
authorAlex Butler <alexheretic@gmail.com>Sun Sep 14 12:42:41 2025 +0100
committerLukas Wirth <me@lukaswirth.dev>Wed Oct 22 09:41:47 2025 +0200
treeee7567428fc1c7ed0b2e6d85ba9d1dc7de46b152
parentb4220df6734f2454991ff5c89d0fac30e39c136d [diff]
CI: Add TEST_BENCHES
1 file changed
tree: ee7567428fc1c7ed0b2e6d85ba9d1dc7de46b152
  1. .github/
  2. benches/
  3. src/
  4. tests/
  5. .gitignore
  6. bors.toml
  7. Cargo.toml
  8. CHANGELOG.md
  9. LICENSE-APACHE
  10. LICENSE-MIT
  11. README.md
README.md

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.

Benchmarks

Run criterion benches with

cargo bench --bench \* -- --quick

MSRV Policy

Minimal Supported Rust Version: latest stable.

Bumping MSRV is not considered a semver-breaking change.