pub struct OffsetString(/* private fields */);
Expand description

A compact representation of a set of unsigned integer ranges.

The primary use case is succinctly encoding a large set of Unicode code points in JSON.

If the set of ranges is

[1..=3, 8..=9, 13..=13, 18..=20]

the OffsetString will be

"1+2,5+1,4,4+3"

In each entry, the first number is the offset from the end of the previous range. If the current range has length > 1, then there’s a ‘+x’ that shows how much to add to get the upper bound of the range. Note that the range [13, 14) has length 1, so it doesn’t get a plus suffix.

Implementations§

source§

impl OffsetString

source

pub fn new<T: AsRef<str>>(source: T) -> Result<OffsetString, Error>

Tries to construct a new OffsetString from a string.

This method performs basic validation on whether the string is syntactically valid and does not contain any redundantly short ranges. Returns an Error if validation fails.

source

pub fn iter_ranges<'a>( &'a self ) -> impl Iterator<Item = RangeInclusive<u32>> + 'a

Iterate over the numeric ranges in the collection.

source

pub fn iter<'a>(&'a self) -> impl Iterator<Item = u32> + 'a

Iterate over the individual unsigned integers in the collection.

Trait Implementations§

source§

impl Debug for OffsetString

source§

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter. Read more
source§

impl<'de> Deserialize<'de> for OffsetString

source§

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>
where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer. Read more
source§

impl From<&CharCollection> for OffsetString

source§

fn from(value: &CharCollection) -> OffsetString

Converts to this type from the input type.
source§

impl From<&CharSet> for OffsetString

source§

fn from(char_set: &CharSet) -> OffsetString

Converts to this type from the input type.
source§

impl From<CharCollection> for OffsetString

source§

fn from(value: CharCollection) -> OffsetString

Converts to this type from the input type.
source§

impl From<CharSet> for OffsetString

source§

fn from(value: CharSet) -> OffsetString

Converts to this type from the input type.
source§

impl From<OffsetString> for String

source§

fn from(value: OffsetString) -> String

Converts to this type from the input type.
source§

impl PartialEq for OffsetString

source§

fn eq(&self, other: &OffsetString) -> bool

This method tests for self and other values to be equal, and is used by ==.
1.0.0 · source§

fn ne(&self, other: &Rhs) -> bool

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
source§

impl Serialize for OffsetString

source§

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>
where __S: Serializer,

Serialize this value into the given Serde serializer. Read more
source§

impl TryFrom<&OffsetString> for CharCollection

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: &OffsetString) -> Result<Self, Self::Error>

Performs the conversion.
source§

impl TryFrom<&OffsetString> for CharSet

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: &OffsetString) -> Result<Self, Self::Error>

Performs the conversion.
source§

impl TryFrom<&str> for OffsetString

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(source: &str) -> Result<OffsetString, Error>

Performs the conversion.
source§

impl TryFrom<OffsetString> for CharCollection

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: OffsetString) -> Result<Self, Self::Error>

Performs the conversion.
source§

impl TryFrom<OffsetString> for CharSet

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(value: OffsetString) -> Result<Self, Self::Error>

Performs the conversion.
source§

impl TryFrom<String> for OffsetString

§

type Error = Error

The type returned in the event of a conversion error.
source§

fn try_from(source: String) -> Result<OffsetString, Error>

Performs the conversion.
source§

impl Eq for OffsetString

source§

impl StructuralPartialEq for OffsetString

Auto Trait Implementations§

Blanket Implementations§

source§

impl<T> Any for T
where T: 'static + ?Sized,

source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
source§

impl<T> Borrow<T> for T
where T: ?Sized,

source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

impl<T> From<T> for T

source§

fn from(t: T) -> T

Returns the argument unchanged.

source§

impl<T, U> Into<U> for T
where U: From<T>,

source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

§

type Error = Infallible

The type returned in the event of a conversion error.
source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
source§

impl<T> DeserializeOwned for T
where T: for<'de> Deserialize<'de>,