#substring #string #substr #str #slice

no-std substring

A substring method for string types

16 stable releases

Uses old Rust 2015

1.4.5 Feb 4, 2021
1.4.4 Jan 31, 2021
1.4.0 Oct 26, 2020

#57 in Text processing

Download history 17798/week @ 2022-06-14 44886/week @ 2022-06-21 45621/week @ 2022-06-28 50265/week @ 2022-07-05 48590/week @ 2022-07-12 20032/week @ 2022-07-19 9334/week @ 2022-07-26 6012/week @ 2022-08-02 6667/week @ 2022-08-09 5584/week @ 2022-08-16 5734/week @ 2022-08-23 4576/week @ 2022-08-30 5258/week @ 2022-09-06 5173/week @ 2022-09-13 5680/week @ 2022-09-20 5073/week @ 2022-09-27

21,644 downloads per month
Used in 63 crates (31 directly)

MIT/Apache

9KB
57 lines

substring

GitHub Workflow Status codecov.io crates.io docs.rs MSRV License

Substring method for string types.

This crate provides a substring method on Rust string types. The method takes a start and end character index and returns a string slice containing the characters within that range.

The method is provided via the Substring trait which is implemented on the str primitive.

Usage

To use this crate, simply bring the Substring trait into scope and call the substring method on your string types.

use substring::Substring;

assert_eq!("hello, world!".substring(7, 12), "world");

Note that the indexing of substrings is based on Unicode Scalar Value. As such, substrings may not always match your intuition:

use substring::Substring;

assert_eq!("".substring(0, 1), "a");  // As opposed to "ã".
assert_eq!("".substring(1, 2), "\u{0303}")

The above example occurs because "ã" is technically made up of two UTF-8 scalar values: the letter "a" and a combining tilde.

Performance

As Rust strings are UTF-8 encoded, the algorithm for finding a character substring has temporal complexity O(n), where n is the byte length of the string. This is due to characters not being of predictible byte lengths.

Minimum Supported Rust Version

This crate is guaranteed to compile on stable rustc 1.0.0 and up.

License

This project is licensed under either of

at your option.

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

No runtime deps