5 releases (2 stable)

new 1.1.0 Jan 13, 2021
1.0.0 Apr 25, 2020
0.99.0 Apr 11, 2020
0.99.0-dev.3 Mar 26, 2020
0.99.0-dev.2 Mar 19, 2020

#140 in Text processing

Download history 3668/week @ 2020-09-23 5095/week @ 2020-09-30 5056/week @ 2020-10-07 4514/week @ 2020-10-14 4698/week @ 2020-10-21 3564/week @ 2020-10-28 3537/week @ 2020-11-04 4250/week @ 2020-11-11 3909/week @ 2020-11-18 3371/week @ 2020-11-25 3613/week @ 2020-12-02 3675/week @ 2020-12-09 3703/week @ 2020-12-16 3655/week @ 2020-12-23 4065/week @ 2020-12-30 3543/week @ 2021-01-06

16,517 downloads per month
Used in 44 crates (5 directly)

MIT/Apache

23KB
420 lines

text-size

Build Status Crates.io API reference

A library that provides newtype wrappers for u32 and (u32, u32) for use as text offsets.

See the docs for more.

License

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.


lib.rs:

Newtypes for working with text sizes/ranges in a more type-safe manner.

This library can help with two things:

  • Reducing storage requirements for offsets and ranges, under the assumption that 32 bits is enough.
  • Providing standard vocabulary types for applications where text ranges are pervasive.

However, you should not use this library simply because you work with strings. In the overwhelming majority of cases, using usize and std::ops::Range<usize> is better. In particular, if you are publishing a library, using only std types in the interface would make it more interoperable. Similarly, if you are writing something like a lexer, which produces, but does not store text ranges, then sticking to usize would be better.

Minimal Supported Rust Version: latest stable.

Dependencies

~69KB