Struct unic_char_range::CharRange

pub struct CharRange {
    pub low: char,
    pub high: char,
}

A range of unicode code points.

The most idiomatic way to construct this range is through the use of the chars! macro:

#[macro_use] extern crate unic_char_range;
use unic_char_range::CharRange;

assert_eq!(chars!('a'..='z'), CharRange::closed('a', 'z'));
assert_eq!(chars!('a'..'z'), CharRange::open_right('a', 'z'));
assert_eq!(chars!(..), CharRange::all());

If constructed in reverse order, such that self.high is ordered before self.low, the range is empty. If you want to iterate in decreasing order, use .iter().rev(). All empty ranges are considered equal no matter the internal state.

Fields

low: char

The lowest character in this range (inclusive).

high: char

The highest character in this range (inclusive).

Methods

impl CharRange

Constructors

pub fn closed(start: char, stop: char) -> CharRange

Construct a closed range of characters.

If stop is ordered before start, the resulting range will be empty.

Example

assert_eq!(
    CharRange::closed('a', 'd').iter().collect::<Vec<_>>(),
    vec!['a', 'b', 'c', 'd']
)

pub fn open_right(start: char, stop: char) -> CharRange

Construct a half open (right) range of characters.

Example

assert_eq!(
    CharRange::open_right('a', 'd').iter().collect::<Vec<_>>(),
    vec!['a', 'b', 'c']
)

pub fn open_left(start: char, stop: char) -> CharRange

Construct a half open (left) range of characters.

Example

assert_eq!(
    CharRange::open_left('a', 'd').iter().collect::<Vec<_>>(),
    vec!['b', 'c', 'd']
)

pub fn open(start: char, stop: char) -> CharRange

Construct a fully open range of characters.

Example

assert_eq!(
    CharRange::open('a', 'd').iter().collect::<Vec<_>>(),
    vec!['b', 'c']
)

pub fn all() -> CharRange

Construct a range over all characters.

impl CharRange

Collection-like fn

pub fn contains(&self, ch: char) -> bool

Does this range include a character?

Examples

assert!(   CharRange::closed('a', 'g').contains('d'));
assert!( ! CharRange::closed('a', 'g').contains('z'));

assert!( ! CharRange:: open ('a', 'a').contains('a'));
assert!( ! CharRange::closed('z', 'a').contains('g'));

pub fn cmp(&self, ch: char) -> Ordering

Determine the ordering of this range and a character.

Panics

Panics if the range is empty. This fn may be adjusted in the future to not panic in optimized builds. Even if so, an empty range will never compare as Ordering::Equal.

pub fn len(&self) -> usize

How many characters are in this range?

pub fn is_empty(&self) -> bool

Is this range empty?

Important traits for CharIter

impl Iterator for CharIter type Item = char;

pub fn iter(&self) -> CharIter

Create an iterator over this range.

Trait Implementations

impl From<CharRange> for CharIter

Important traits for CharIter

impl Iterator for CharIter type Item = char;

fn from(range: CharRange) -> CharIter

Performs the conversion.

impl From<CharIter> for CharRange

fn from(iter: CharIter) -> CharRange

Performs the conversion.

impl Copy for CharRange

impl Clone for CharRange

fn clone(&self) -> CharRange

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for CharRange

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

Formats the value using the given formatter.

impl Eq for CharRange

impl IntoIterator for CharRange

type Item = char

The type of the elements being iterated over.

type IntoIter = CharIter

Which kind of iterator are we turning this into?

Important traits for CharIter

impl Iterator for CharIter type Item = char;

fn into_iter(self) -> CharIter

Creates an iterator from a value.

impl PartialEq<CharRange> for CharRange

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

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

#[must_use] fn ne(&self, other: &Rhs) -> bool

This method tests for !=.