Struct Boundary 

pub struct Boundary { /* private fields */ }

A validated boundary with its delimiter (CRLF "--" boundary, 5 to 74 bytes) and the failure table of the streaming matcher, built once.

Debug prints the boundary: it is not secret.

Examples

use form_net::Boundary;

let b = Boundary::new(b"----WebKitFormBoundaryx7Y")?;
assert_eq!(b.delimiter(), b"\r\n------WebKitFormBoundaryx7Y");
assert!(Boundary::new(b"").is_err());
assert!(Boundary::new(&[b'a'; 71]).is_err());
assert!(Boundary::new(b"ends with space ").is_err());
assert!(Boundary::new(b"has\"quote").is_err());
assert_eq!(Boundary::parse(b"multipart/form-data; boundary=\"a b\"")?.as_bytes(), b"a b");

Implementations

impl Boundary

pub fn new(boundary: &[u8]) -> Result<Boundary, FormError>

Validates a bare boundary (without --): 1 to 70 bytes of RFC 2046 bchars, not ending in a space.

Errors

Syntax { InvalidBoundary }, at the offending byte.

Examples

assert_eq!(form_net::Boundary::new(b"X")?.delimiter(), b"\r\n--X");

pub fn parse(content_type: &[u8]) -> Result<Boundary, FormError>

Reads the boundary from a whole multipart/form-data Content-Type value.

Errors

UnsupportedMediaType for any other media type; Syntax { InvalidContentType | MissingBoundary | DuplicateBoundary | InvalidBoundary }.

Examples

let b = form_net::Boundary::parse(b"multipart/form-data; boundary=----x")?;
assert_eq!(b.as_bytes(), b"----x");
assert!(form_net::Boundary::parse(b"text/plain").is_err());

pub fn as_bytes(&self) -> &[u8]

The boundary, without --.

Examples

assert_eq!(form_net::Boundary::new(b"abc")?.as_bytes(), b"abc");

pub fn delimiter(&self) -> &[u8]

The full delimiter: CRLF, --, and the boundary.

Examples

assert_eq!(form_net::Boundary::new(b"abc")?.delimiter(), b"\r\n--abc");

Trait Implementations

impl Clone for Boundary

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for Boundary

impl Debug for Boundary

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

Formats the value using the given formatter.

impl Eq for Boundary

impl PartialEq for Boundary

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for Boundary