Struct Quoter

pub struct Quoter { /* private fields */ }

Partial percent-decoding.

Performs percent-decoding on a slice but can selectively skip decoding certain sequences.

Examples

// + is set as a protected character and will not be decoded...
let q = Quoter::new(&[], b"+");

// ...but the other encoded characters (like the hyphen below) will.
assert_eq!(q.requote(b"/a%2Db%2Bc").unwrap(), b"/a-b%2Bc");

Implementations

impl Quoter

pub fn new(_: &[u8], protected: &[u8]) -> Quoter

Constructs a new Quoter instance given a set of protected ASCII bytes.

The first argument is ignored but is kept for backward compatibility.

Panics

Panics if any of the protected bytes are not in the 0-127 ASCII range.

pub fn requote(&self, val: &[u8]) -> Option<Vec<u8>>

Partially percent-decodes the given bytes.

Escape sequences of the protected set are not decoded.

Returns None when no modification to the original bytes was required.

Invalid/incomplete percent-encoding sequences are passed unmodified.