28 releases

0.7.5 Nov 16, 2023
0.7.3 Sep 23, 2023
0.7.1 Jan 26, 2023
0.7.0 Sep 26, 2022
0.3.2 Oct 28, 2019

#27 in Data structures

Download history 47481/week @ 2023-12-15 34445/week @ 2023-12-22 35659/week @ 2023-12-29 48282/week @ 2024-01-05 47640/week @ 2024-01-12 49587/week @ 2024-01-19 52029/week @ 2024-01-26 57828/week @ 2024-02-02 58528/week @ 2024-02-09 60326/week @ 2024-02-16 58935/week @ 2024-02-23 58924/week @ 2024-03-01 63283/week @ 2024-03-08 60975/week @ 2024-03-15 64426/week @ 2024-03-22 51092/week @ 2024-03-29

249,784 downloads per month
Used in 363 crates (34 directly)

Custom license

215KB
4K SLoC

tinystr crates.io

tinystr is a utility crate of the ICU4X project.

It includes TinyAsciiStr, a core API for representing small ASCII-only bounded length strings.

It is optimized for operations on strings of size 8 or smaller. When use cases involve comparison and conversion of strings for lowercase/uppercase/titlecase, or checking numeric/alphabetic/alphanumeric, TinyAsciiStr is the edge performance library.

Examples

use tinystr::TinyAsciiStr;

let s1: TinyAsciiStr<4> = "tEsT".parse().expect("Failed to parse.");

assert_eq!(s1, "tEsT");
assert_eq!(s1.to_ascii_uppercase(), "TEST");
assert_eq!(s1.to_ascii_lowercase(), "test");
assert_eq!(s1.to_ascii_titlecase(), "Test");
assert!(s1.is_ascii_alphanumeric());
assert!(!s1.is_ascii_numeric());

let s2 = TinyAsciiStr::<8>::try_from_raw(*b"New York")
    .expect("Failed to parse.");

assert_eq!(s2, "New York");
assert_eq!(s2.to_ascii_uppercase(), "NEW YORK");
assert_eq!(s2.to_ascii_lowercase(), "new york");
assert_eq!(s2.to_ascii_titlecase(), "New york");
assert!(!s2.is_ascii_alphanumeric());

Details

When strings are of size 8 or smaller, the struct transforms the strings as u32/u64 and uses bitmasking to provide basic string manipulation operations:

  • is_ascii_numeric
  • is_ascii_alphabetic
  • is_ascii_alphanumeric
  • to_ascii_lowercase
  • to_ascii_uppercase
  • to_ascii_titlecase
  • PartialEq

TinyAsciiStr will fall back to u8 character manipulation for strings of length greater than 8.

More Information

For more information on development, authorship, contributing etc. please visit ICU4X home page.

Dependencies

~0.3–0.8MB
~20K SLoC