pub fn len<'v, V, L, R>(value: V, range: R) -> Result<'v, ()>
Expand description
Length validator: succeeds when the length of a value is within a range
.
The value must implement Len
. On error, returns an InvalidLength
error. See Len
for supported types and how their length is computed.
§Data Limits
All form types are constrained by a data limit. As such, the len()
validator should be used only when a data limit is insufficiently specific.
For example, prefer to use data Limits
to validate
the length of files as not doing so will result in writing more data to disk
than necessary.
§Example
use rocket::http::ContentType;
use rocket::form::{FromForm, FromFormField};
use rocket::data::ToByteUnit;
use rocket::fs::TempFile;
#[derive(FromForm)]
struct Foo<'r> {
#[field(validate = len(5..20))]
name: &'r str,
#[field(validate = len(..=200))]
maybe_name: Option<&'r str>,
#[field(validate = len(..=2.mebibytes()))]
#[field(validate = ext(ContentType::Plain))]
file: TempFile<'r>,
}