9 releases

0.3.1 Sep 13, 2024
0.3.0 Dec 2, 2021
0.2.1 Jun 27, 2019
0.2.0 Mar 6, 2019
0.0.0 Jul 25, 2017

#101 in Data structures

Download history 9204/week @ 2024-09-25 7612/week @ 2024-10-02 8159/week @ 2024-10-09 9997/week @ 2024-10-16 9707/week @ 2024-10-23 10572/week @ 2024-10-30 10231/week @ 2024-11-06 9004/week @ 2024-11-13 8964/week @ 2024-11-20 11605/week @ 2024-11-27 10919/week @ 2024-12-04 12588/week @ 2024-12-11 8752/week @ 2024-12-18 3250/week @ 2024-12-25 6541/week @ 2025-01-01 8698/week @ 2025-01-08

29,347 downloads per month
Used in 1,163 crates (via twitter-stream)

MIT license

13KB
178 lines

String

A UTF-8 encoded string with configurable byte storage.

Build Status License: MIT Crates.io Documentation

Usage

To use string, first add this to your Cargo.toml:

[dependencies]
string = "0.3.1"

Next, add this to your crate:

extern crate string;

use string::{String, TryFrom};

let s: String<[u8; 2]> = String::try_from([b'h', b'i']).unwrap();
assert_eq!(&s[..], "hi");

See documentation for more details.


lib.rs:

A UTF-8 encoded string with configurable byte storage.

This crate provides String, a type similar to its std counterpart, but with one significant difference: the underlying byte storage is configurable. In other words, String<T> is a marker type wrapping T, indicating that it represents a UTF-8 encoded string.

For example, one can represent small strings (stack allocated) by wrapping an array:

let s: String<[u8; 2]> = String::try_from([b'h', b'i']).unwrap();
assert_eq!(&s[..], "hi");

Dependencies

~195KB