Struct ControlCharRule 

pub struct ControlCharRule { /* private fields */ }

Rejects input containing control characters (U+0000–U+001F, U+007F, U+0080–U+009F).

Allowed exceptions can be configured (e.g. tab \t).

Rationale

Control characters (especially newline, NUL, ESC) can cause:

• Command splitting when injected into shell strings
• Terminal escape sequence attacks
• NUL-byte truncation in C-backed APIs

Implementations

impl ControlCharRule

pub fn allowing(chars: &[char]) -> Self

Create a rule that permits specific control characters.

use shell_sanitize_rules::ControlCharRule;

// Allow tab but reject everything else
let rule = ControlCharRule::allowing(&['\t']);

Trait Implementations

impl Default for ControlCharRule

fn default() -> Self

Returns the “default value” for a type.

impl Rule for ControlCharRule

fn name(&self) -> &'static str

A unique, human-readable identifier for this rule.

fn check(&self, input: &str) -> RuleResult

Check the input and return violations, if any.