Struct FormFieldValue 

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

A value from a form field.

This type represents a value from a form field, which can be either a text value or a multipart field (like a file upload). It provides methods to access the field’s metadata (name, filename, content type) and to convert the value into different formats.

Implementations

impl<'a> FormFieldValue<'a>

pub fn new_text<T: Into<String>>(text: T) -> Self

Creates a new text field value.

Examples

use cot::form::FormFieldValue;

let value = FormFieldValue::new_text("hello");
assert_eq!(value.is_multipart(), false);
assert_eq!(value.filename(), None);
assert_eq!(value.content_type(), None);
assert_eq!(value.into_text().await?, "hello");

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

Returns the filename of the field, if it has one.

Only multipart fields can have filenames. Text fields always return None.

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

Returns the content type of the field, if it has one.

Only multipart fields can have content types. Text fields always return None.

pub async fn into_bytes(self) -> Result<Bytes, FormFieldValueError>

Converts the field value into bytes.

For text fields, this converts the text into bytes. For multipart fields, this reads the field’s content as bytes.

Errors

This method can return an error if the field is a multipart field and the content cannot be read, for example, because of an I/O error.

Examples

use bytes::Bytes;
use cot::form::FormFieldValue;

let text_value = FormFieldValue::new_text("hello");
assert_eq!(text_value.into_bytes().await?, Bytes::from("hello"));

pub async fn into_text(self) -> Result<String, FormFieldValueError>

Converts the field value into text.

For text fields, this returns the text directly. For multipart fields, this reads the field’s content as text.

Errors

This method can return an error if the field is a multipart field and the content cannot be read, for example, because of an I/O error.

Examples

use cot::form::FormFieldValue;

let text_value = FormFieldValue::new_text("hello");
assert_eq!(text_value.into_text().await?, "hello");

pub fn is_multipart(&self) -> bool

Returns whether this is a multipart field.

Examples

use cot::form::FormFieldValue;

let text_value = FormFieldValue::new_text("hello");
assert!(!text_value.is_multipart());

Trait Implementations

impl<'a> Debug for FormFieldValue<'a>

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

Formats the value using the given formatter.