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 Unicode characters (Unicode Scalar Values).

pub fn assigned_normal_planes() -> CharRange

Construct a range over all characters of assigned Unicode Planes.

Assigned normal (non-special) Unicode Planes are:

• Plane 0: Basic Multilingual Plane (BMP)
• Plane 1: Supplementary Multilingual Plane (SMP)
• Plane 2: Supplementary Ideographic Plane (SIP)

Unicode Plane 14, Supplementary Special-purpose Plane (SSP), is not included in this range, mainly because of the limit of CharRange only supporting a continuous range.

Unicode Planes 3 to 13 are Unassigned planes and therefore excluded.

Unicode Planes 15 and 16 are Private Use Area planes and won't have Unicode-assigned characters.

impl CharRange

Collection-like fns

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_char(&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 Debug for CharRange

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

Formats the value using the given formatter.

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 !=.

impl Eq for CharRange

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 IntoIterator for CharRange

type IntoIter = CharIter

Which kind of iterator are we turning this into?

type Item = char

The type of the elements being iterated over.

Important traits for CharIter

impl Iterator for CharIter type Item = char;

fn into_iter(self) -> CharIter

Creates an iterator from a value.

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.