Struct actix_web::http::header::ContentDisposition

pub struct ContentDisposition {
    pub disposition: DispositionType,
    pub parameters: Vec<DispositionParam>,
}

A Content-Disposition header, (re)defined in RFC6266.

The Content-Disposition response header field is used to convey additional information about how to process the response payload, and also can be used to attach additional metadata, such as the filename to use when saving the response payload locally.

ABNF

content-disposition = "Content-Disposition" ":"
                      disposition-type *( ";" disposition-parm )

disposition-type    = "inline" | "attachment" | disp-ext-type
                      ; case-insensitive

disp-ext-type       = token

disposition-parm    = filename-parm | disp-ext-parm

filename-parm       = "filename" "=" value
                    | "filename*" "=" ext-value

disp-ext-parm       = token "=" value
                    | ext-token "=" ext-value

ext-token           = <the characters in token, followed by "*">

Example

use actix_web::http::header::{ContentDisposition, DispositionType, DispositionParam, Charset};

let cd1 = ContentDisposition {
    disposition: DispositionType::Attachment,
    parameters: vec![DispositionParam::Filename(
      Charset::Iso_8859_1, // The character set for the bytes of the filename
      None, // The optional language tag (see `language-tag` crate)
      b"\xa9 Copyright 1989.txt".to_vec() // the actual bytes of the filename
    )]
};

let cd2 = ContentDisposition {
    disposition: DispositionType::Inline,
    parameters: vec![DispositionParam::Filename(
      Charset::Ext("UTF-8".to_owned()),
      None,
      "\u{2764}".as_bytes().to_vec()
    )]
};

Fields

disposition: DispositionType

The disposition

parameters: Vec<DispositionParam>

Disposition parameters

Methods

impl ContentDisposition

pub fn from_raw(hv: &HeaderValue) -> Result<Self, ParseError>

Parse a raw Content-Disposition header value

Trait Implementations

impl PartialEq<ContentDisposition> for ContentDisposition

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl Clone for ContentDisposition

fn clone(&self) -> ContentDisposition

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Display for ContentDisposition

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

Formats the value using the given formatter.

impl Debug for ContentDisposition

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

Formats the value using the given formatter.