Crate pascal_string [−] [src]
ShortString is a String which stores its data on the stack. Because of this, it has
a fixed maximum size, which cannot be changed. Traditionally, the size of a
PascalString is 256 bytes -
the first byte stores the length, which means that each remaining byte is indexable using only that byte.
This is a very niche string type - generally, you are better off using
std::string::String, or the
AsciiString type from the
ascii crate if you need an ascii string. They have no upper size limit, and
are cheaper to pass around as they are only 64 bytes on the stack. Generally, you should only use
- You know that you absolutely, certainly cannot do without heap allocation.
- You need to store your string data inline into your
structtype - for example if you will allocate a bunch of these custom
structtypes into a pool allocator, and cannot afford the heap fragmentation.
- You will keep, allocate, and deallocate a lot of short strings in your program.
An immutable iterator over the buffer of a
A mutable iterator over the buffer of a
An iterator over the buffer of a
An iterator over the lines of the internal character array.
A borrowed slice from a
An error type which abstracts over ascii conversion errors.
Indicates the range of errors which can occur from appending string data to a
Indicates the range of errors which can occur from creating a new