Struct yapg::CharsetSpec

pub struct CharsetSpec { /* fields omitted */ }

Represents a specification for a charset

Any of the predefined CharsetNames can be toggled and additional characters may be included. For this purpose, CharsetSpec implements AddAssign<CharsetName> and SubAssign<CharsetName>. Alternatively, you can parse a string containing the corresponding chars.

Example

let mut spec = yapg::CharsetSpec::empty();
spec += yapg::CharsetName::Numeric; // Adding a named charset
spec += "+-*"; // Adding a string
spec += '/'; // Adding a single char

assert_eq!(spec.construct().as_slice(), [
    '*', '+', '-', '/', '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
]);

Implementations

impl CharsetSpec

pub fn construct(self) -> Vec<char>

Builds the actual character set in form of a Vec<char>, which is sorted and deduplicated.

pub fn empty() -> Self

Creates the specification for an empty charset.

Example

let charset = yapg::CharsetSpec::empty().construct();
assert_eq!(charset.len(), 0);

pub fn std64() -> Self

Creates the specification for a standard charset, including all alphanumerics, - and _. Should be safe to use in most places, except for strict “no-special-characters”-policies or where neither - nor _ are considered to be special, yet special chars are required.

Example

let charset = yapg::CharsetSpec::std64().construct();
assert_eq!(charset.len(), 64);

pub fn printable_ascii() -> Self

Creates the specification for charset that contains all printable ASCII characters.

Example

let charset = yapg::CharsetSpec::printable_ascii().construct();
assert_eq!(charset.len(), 95);

Trait Implementations

impl AddAssign<&'_ str> for CharsetSpec

fn add_assign(&mut self, more: &str)

Performs the += operation.

impl AddAssign<CharsetName> for CharsetSpec

fn add_assign(&mut self, name: CharsetName)

Performs the += operation.

impl AddAssign<char> for CharsetSpec

fn add_assign(&mut self, c: char)

Performs the += operation.

impl Debug for CharsetSpec

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

Formats the value using the given formatter.

impl FromStr for CharsetSpec

type Err = Error

The associated error which can be returned from parsing.

fn from_str(s: &str) -> Result<Self>

Parses a string s to return a value of this type.

impl Into<Vec<char, Global>> for CharsetSpec

fn into(self) -> Vec<char>

Performs the conversion.

impl SubAssign<CharsetName> for CharsetSpec

fn sub_assign(&mut self, name: CharsetName)

Performs the -= operation.