Struct FieldValue 

pub struct FieldValue(/* private fields */);

The value of one field line.

Bytes rather than a str: RFC 9110 §5.5 admits obs-text (%x80-FF) into a field value, so one is not necessarily UTF-8. The single place this server reads a value as text – credentials – asks for it with Self::to_str and says what it does when the answer is no.

Implementations

impl FieldValue

pub fn from_static(value: &'static str) -> Self

Wraps a value this server authored.

Panics

On an octet no field value may carry. The bound to 'static is what makes that acceptable: the argument is a literal in this tree, so a panic here is a bug found by the first test that sends the field, never something a peer can provoke.

pub fn parse(value: &[u8]) -> Option<Self>

Reads a value that arrived from a peer, or one built at runtime.

None for an octet that may not appear in a field value; RFC 9114 §10.3 makes that a malformed message, and super::stream is where it becomes one.

The accepted set is VCHAR (%x21-7E), obs-text (%x80-FF), SP and HTAB – so CR, LF, NUL, every other control character and DEL are refused. RFC 9110 §5.5’s field-content additionally forbids a leading or trailing SP or HTAB, and that placement rule is deliberately not enforced here: §10.3’s concern is the three characters that would be exploited by an intermediary translating the message, all three of which are refused, and refusing a value with a stray leading space would turn a request that every other HTTP/3 implementation accepts into a stream error.

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

The value as it appears on the wire.

pub fn to_str(&self) -> Option<&str>

The value as text, or None if it is not UTF-8.

pub fn len(&self) -> usize

How many octets the value is.

pub fn is_empty(&self) -> bool

Whether the value is the empty string, which is a legal field value.

Trait Implementations

impl Clone for FieldValue

fn clone(&self) -> FieldValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for FieldValue

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

As text where the value is text, so a failing assertion is readable.

impl Eq for FieldValue

impl PartialEq for FieldValue

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

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl StructuralPartialEq for FieldValue