Struct TransferCodings 

pub struct TransferCodings { /* private fields */ }

A collection of transfer codings with validation according to HTTP standards.

This struct ensures that:

• “chunked” appears at most once
• “chunked” is always the last transfer coding

Implementations

impl TransferCodings

pub fn new() -> TransferCodings

Creates a new empty TransferCodings collection.

Returns

A new TransferCodings instance

Examples

use crate::encoding::TransferCodings;

let codings = TransferCodings::new();
assert!(codings.is_identity());

pub fn push(&mut self, coding: TransferCoding) -> Result<(), &'static str>

Adds a transfer coding to the collection, with validation.

According to HTTP standards:

• “chunked” can appear at most once
• “chunked” must be the last transfer coding

Arguments

• coding - The transfer coding to add

Returns

Ok(()) if the coding was successfully added, or an error message explaining why the coding could not be added.

Examples

use crate::encoding::{TransferCodings, TransferCoding};

let mut codings = TransferCodings::new();

// Add a non-chunked coding
codings.push(TransferCoding::Other("gzip".into())).unwrap();

// Add chunked coding (must be last)
codings.push(TransferCoding::Chunked).unwrap();

// Cannot add another coding after chunked
assert!(codings.push(TransferCoding::Other("compress".into())).is_err());

// Cannot add chunked twice
let mut codings = TransferCodings::new();
codings.push(TransferCoding::Chunked).unwrap();
assert!(codings.push(TransferCoding::Chunked).is_err());

pub fn is_chunked(&self) -> bool

Checks if chunked transfer encoding is used.

Returns

true if chunked encoding is present, false otherwise

Examples

use crate::encoding::{TransferCodings, TransferCoding};

let mut codings = TransferCodings::new();
assert!(!codings.is_chunked());

codings.push(TransferCoding::Chunked).unwrap();
assert!(codings.is_chunked());

pub fn is_identity(&self) -> bool

Checks if identity transfer encoding is used (no transfer encoding).

Returns

true if no transfer encodings are present, false otherwise

Examples

use crate::encoding::{TransferCodings, TransferCoding};

let mut codings = TransferCodings::new();
assert!(codings.is_identity());

codings.push(TransferCoding::Chunked).unwrap();
assert!(!codings.is_identity());

pub fn to_header(&self) -> String

Converts the transfer codings to a header value string.

Returns

A comma-separated string of transfer codings

Examples

use crate::encoding::{TransferCodings, TransferCoding};

let mut codings = TransferCodings::new();
codings.push(TransferCoding::Other("gzip".into())).unwrap();
codings.push(TransferCoding::Chunked).unwrap();

assert_eq!(codings.to_header(), "gzip, chunked");

Trait Implementations

impl Clone for TransferCodings

fn clone(&self) -> TransferCodings

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for TransferCodings

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

Formats the value using the given formatter.

impl Default for TransferCodings

fn default() -> TransferCodings

Returns the “default value” for a type.