NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
crates.io
crates.io, #1174 most downloaded on crates.io
Compact inlined strings
Latest stable
2.0.0
Last release 20 days ago
01 Nov 2026
Ships unpredictably
gaps range from 3 weeks to 4.6 years
Nearly every release is documented
notes for 15 of 15 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
15 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Note that this crate now lives on Codeberg.
Note that this crate now lives on Codeberg.
New methods matching their std::string::String counterparts: SmartString::shrink_to,
SmartString::extend_from_within, SmartString::into_bytes and
SmartString::into_boxed_str.
New trait impls matching their std::string::String counterparts:
AsRef<std::ffi::OsStr> and AsRef<std::path::Path> (with the std feature flag)From<char>AddAssign<&SmartString<Mode>>, AddAssign<&str> and AddAssign<&String>From<SmartString<Mode>> for Box<str>PartialOrd<str>, PartialOrd<&str> and PartialOrd<String>, along with their
mirrored impls on str, &str and StringThe From<Cow<str>>, Extend<Cow<str>> and FromIterator<Cow<str>> trait impls are now
available without the std feature flag, behind which they were incorrectly
hidden previously.
Some trait impls which have no counterpart on std::string::String have been
removed, to keep the API strictly aligned with String:
Extend<&SmartString<Mode>>Extend<&String>Add<SmartString<Mode>> for SmartString<Mode>Add<String> for SmartString<Mode>Add<SmartString<Mode>> for StringFromIterator<&SmartString<Mode>>FromIterator<&String>Performance improvements (benchmarks, which are largely about B-tree key lookups, are now roughly 10% faster on average):
ensure_capacity() no longer calls realloc() when the current capacity is already
sufficient, which removes an allocator round trip from every push, push_str and
insert on boxed strings.
The inline/boxed discriminant check is now a single bitwise operation instead of
ptr::align_offset().
The From<&str>, From<&mut str> and From<&String> impls no longer have
a risk of allocating and copying twice when constructing a boxed SmartString.
retain() is now using a more optimised algorithm.
Extend<char>, Extend<&char> and FromIterator<char> now preallocate based on the
iterator's lower size bound instead of growing the string repeatedly.
Your coding agent can read these notes before it upgrades. Set up the MCP server →
To avoid an issue where allocated heap memory may be deallocated with a different layout alignment than it was officially allocated with when converti
std::string::String and SmartString, even if otherwise correctly aligned, the respective From implementations now use std::alloc::Allocator::grow() to re-align the heap data as necessary. An unfortunate consequence of this is that because the std::alloc::Allocator API hasn't been stabilised yet, unless you're on nightly or some future stable rustc version after allocator_api has been stabilised, converting between String and SmartString will always reallocate and copy (making it always O(n) rather than O(1) when correctly aligned and O(n) otherwise). (#28)smartstring now implements its own boxed string type rather than deferring directly to String , so it no longer makes assumptions it shouldn't be maki
smartstring now implements its own boxed string type rather than deferring directly to String, so it no longer makes assumptions it shouldn't be making about the layout of the String struct.
This also allows us to organise the boxed struct in a way that will let us rely only on our basic assumption that heap memory is word aligned on both big and little endian architectures. The most immediate consequence of this is that smartstring will now compile on 32-bit big endian architectures such as mips.
We are now also explicitly allocating heap memory aligned for u16 rather than u8, ensuring the assumption about pointer alignment becomes an invariant.
In short: smartstring no longer relies on undefined behaviour, and should be safe to use anywhere.
The above means that the boxed SmartString is no longer pointer compatible with String, so if you were relying on that despite the documentation urging you not to, you'll really have to stop it now. Converting between SmartString and String using From and Into traits is still efficient and allocation free.
The minimum supported rustc version is now 1.57.0.
The smartstring::validate() function has been removed, as it's no longer needed.
The minimum supported rustc version has been increased to 1.56.0, and the rust-version field has been added to the crate's Cargo.toml to indicate the
rust-version field has been added to the crate's Cargo.toml to indicate the MSRV. (The rust-version field itself was introduced in version 1.56, hence the bump.)arbitrary version 1.You can (and should) now call smartstring::validate() from your own code or test suite to validate SmartString 's memory layout assumptions.
smartstring::validate() from your own code or test suite to validate SmartString's memory layout assumptions.Please note that when rustc catches up, the plan is to deprecate new_const() in favour of new() .
There are now const fn new_const() constructors for SmartString<Compact> and SmartString<LazyCompact>, added as a temporary measure because const functions can't yet take trait bounds on type arguments, so we can't simply make SmartString::new() const.
Please note that when rustc catches up, the plan is to deprecate new_const() in favour of new(). (#21)
FIXED no_std builds have been fixed.
no_std builds have been fixed. (#18)SmartString now implements PartialEq<&str> .
SmartString now implements PartialEq<&str>. (#16)From implementations from Cow<'_, str> and &mut str were added.
From implementations from Cow<'_, str> and &mut str were added. (#12)From implementations from Cow<'_, str> and &mut str were added. (#12)(cargo-release) smartstring version 0.2.4
(cargo-release) smartstring version 0.2.4
smartstring is now no_std if you disable the std feature flag (which is enabled by
default). (#10)smartstring will now refuse to compile on 32-bit big-endian architectures, where assuming that
the high bit of a pointer is always empty is going to be a very bad idea.SmartString now implements Display .
SmartString now implements Display. (#6)SmartString now implements FromIterator<char>.serde behind the serde feature flag. (#2)arbitrary behind the arbitrary feature flag.proptest behind the proptest feature flag.SmartString::push_str would previously trigger two heap allocations while promoting an inline string to a boxed string, one of which was unnecessary. It now only makes the one strictly necessary allocation. (#5)SmartString::remove would panic if you tried to remove the last index in an inline string.Calling shrink_to_fit() on a string with LazyCompact layout will now inline it and deallocate the heap allocation if the string is short enough to be
shrink_to_fit() on a string with LazyCompact layout will now inline it and deallocate the heap allocation if the string is short enough to be inlined.The type alias smartstring::String was incorrectly pointing at the Compact variant. It is now pointing at LazyCompact, as the documentation describes.
smartstring::alias::String was incorrectly pointing at the Compact variant. It is now pointing at LazyCompact, as the documentation describes.The Prefixed variant has been removed, as it comes with significant code complexity for very dubious gains.
Prefixed variant has been removed, as it comes with significant code complexity for very dubious gains.smartstring::alias::String now refers to LazyCompact instead of Compact, the idea being that the obvious drop-in replacement for String shouldn't have any unexpected performance differences, which Compact can have because it aggressively re-inlines strings to keep them as local as possible. LazyCompact instead heap allocates once when the string is in excess of the inline capacity and keeps the allocation from then on, so there are no surprises.LazyCompact, which works like Compact except it never re-inlines strings once they have been moved to the heap.String has changed, there is now a new type alias smartstring::alias::CompactString, referring to strings with Compact layout.SmartString::drain() would remove twice the drained content from the string.Initial release.
Initial release.
One column per quarter.