smartstring
Compact inlined strings.
Overview
This crate provides a wrapper for Rust's standard String
which uses the space a String
occupies
on the stack to store inline string data, automatically promoting it to a String
when it grows
beyond the inline capacity. This has the advantage of avoiding heap allocations for short strings as
well as improving performance thanks to keeping the strings on the stack.
This is all accomplished without the need for an external discriminant, so a SmartString
is
exactly the same size as a String
on the stack, regardless of whether it's inlined or not, and
when not inlined it's pointer compatible with String
, meaning that you can safely coerce a
SmartString
to a String
using std::mem::replace()
or pointer::cast()
and go on using it as
if it had never been a SmartString
. (But please don't do that, there's an Into<String>
implementation that's much safer.)
There's also a more memory hungry variant which keeps a copy of the first few bytes of the string on the stack even when it's heap allocated, for cases where it can be useful to do a quick cache local comparison between two strings to immediately eliminate equality.
Documentation
Licence
Copyright 2020 Bodil Stokke
This software is subject to the terms of the Mozilla Public License, v. 2.0. If a copy of the MPL was not distributed with this file, You can obtain one at http://mozilla.org/MPL/2.0/.
Code of Conduct
Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.