Struct InputMask 

pub struct InputMask { /* private fields */ }

Parsed mask: a sequence of positions, ready for rendering and per-character routing.

Implementations

impl InputMask

pub fn parse(mask: &str) -> Result<Self, MaskError>

Parse a Qt-grammar mask string. Errors only on a trailing backslash with nothing to escape; any unrecognized printable char becomes a fixed literal. (Qt is similarly permissive.)

pub fn len(&self) -> usize

Total number of positions (editable + fixed).

pub fn is_empty(&self) -> bool

true if the parsed mask has no positions.

pub fn positions(&self) -> impl Iterator<Item = &MaskPosition>

Iterator over positions in document order.

pub fn get(&self, i: usize) -> Option<&MaskPosition>

Position at index i, or None if out of bounds.

pub fn empty_template(&self, placeholder_char: char) -> String

Render the mask as the empty-state template: every editable position becomes placeholder_char, every fixed position keeps its literal. So 99/99/9999 with _ → "__/__/____".

pub fn format(&self, raw: &str, placeholder_char: char) -> FormattedMask

Apply the mask to raw input. Walks raw and the mask in lockstep:

• At a fixed-separator position, the separator is appended automatically (the user doesn’t need to type it). If the next raw char matches the separator it’s consumed; otherwise it stays for the next editable position.
• At an editable position, the next raw char is consumed if it fits the class, else dropped.
• Case lock is applied to letter/alphanumeric/any chars.
• When raw is exhausted, the rest of the formatted string uses placeholder_char for editable positions and the literal for fixed ones — giving a partial template like "12/__/____".

The result is the fully-templated string (with placeholder characters for unfilled positions), suitable for direct rendering. To get just the user’s input keep raw and don’t call this; to get a string with separators but no placeholders, truncate at the position past the last filled editable slot.

pub fn strip_trailing_placeholders(&self, formatted: &FormattedMask) -> String

Strip placeholder characters from the tail of a formatted string. Returns the prefix containing only filled positions and their preceding separators. "12/__/____" → "12/", "12/30/____" → "12/30/", "____" → "".

pub fn accepts_at(&self, pos_index: usize, c: char) -> bool

Position-aware char filter: returns true iff c would be accepted at editable position pos_index. Fixed positions never accept input directly (the caret should skip over them). Out-of-range indices reject. Used by composites that want to gate keystrokes per-position.

Trait Implementations

impl Clone for InputMask

fn clone(&self) -> InputMask

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for InputMask

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

Formats the value using the given formatter.

impl Eq for InputMask

impl PartialEq for InputMask

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for InputMask