Struct Quoted 

pub struct Quoted<'a> { /* private fields */ }

A validated quoted string: the bytes between the quotes, and whether any quoted pair occurs.

Debug prints the raw bytes as an escaped byte string.

Examples

use parse_net::text;

let (q, _) = text::parse_quoted(b"\"say \\\"hi\\\"\"")?;
assert!(q.has_escapes() && q.as_plain().is_none());
assert_eq!(q.unescaped_len(), 8);
let mut buf = [0u8; 8];
assert_eq!(q.unescape_into(&mut buf)?, b"say \"hi\"");
assert!(q.eq_bytes(b"say \"hi\""));
let mut short = [0u8; 7];
assert_eq!(q.unescape_into(&mut short).unwrap_err().kind(), parse_net::ErrorKind::BufferTooSmall);

Implementations

impl<'a> Quoted<'a>

pub const fn raw(&self) -> &'a [u8]

The content between the quotes exactly as sent, quoted pairs included.

pub const fn has_escapes(&self) -> bool

Whether the content contains a quoted pair (\x).

pub const fn as_plain(&self) -> Option<&'a [u8]>

The content when it contains no quoted pair: the value, with no copy.

pub fn unescaped_len(&self) -> usize

The length of the value with quoted pairs replaced.

pub fn bytes(&self) -> Unescape<'a>

The bytes of the value with quoted pairs replaced.

pub fn unescape_into<'b>( &self, out: &'b mut [u8], ) -> Result<&'b [u8], ParseError>

Writes the value into out, every quoted pair replaced by the byte after the backslash, and returns the written part.

Errors

ErrorKind::BufferTooSmall when out is shorter than unescaped_len; nothing is written.

pub fn eq_bytes(&self, other: &[u8]) -> bool

Whether the value equals other, compared without a buffer.

pub fn eq_ignore_ascii_case(&self, other: &[u8]) -> bool

Whether the value equals other ignoring ASCII case, compared without a buffer.

Trait Implementations

impl<'a> Clone for Quoted<'a>

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<'a> Copy for Quoted<'a>

impl Debug for Quoted<'_>

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

Formats the value using the given formatter.

impl<'a> Eq for Quoted<'a>

impl<'a> Hash for Quoted<'a>

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> PartialEq for Quoted<'a>

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

Equality operator ==.

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

Inequality operator !=.

impl<'a> StructuralPartialEq for Quoted<'a>