Struct ZOptional 

pub struct ZOptional<T: VldSchema> { /* private fields */ }

Wraps a schema to make it optional.

If the value is null or missing, returns Ok(None). Otherwise, delegates to the inner schema and wraps the result in Some.

Implementations

impl<T: VldSchema> ZOptional<T>

pub fn new(inner: T) -> Self

pub fn inner_schema(&self) -> &T

Access the inner schema (for JSON Schema generation).

Trait Implementations

impl<T: VldSchema> VldSchema for ZOptional<T>

type Output = Option<<T as VldSchema>::Output>

The Rust type produced by this schema after successful parsing.

fn parse_value(&self, value: &Value) -> Result<Option<T::Output>, VldError>

Parse and validate a serde_json::Value.

fn parse<I: VldInput + ?Sized>( &self, input: &I, ) -> Result<Self::Output, VldError>

Parse from any supported input (JSON string, file path, serde_json::Value, etc.)

fn optional(self) -> ZOptional<Self>

Make this field optional. Missing or null values become None.

fn nullable(self) -> ZNullable<Self>

Allow null values. Null becomes None.

fn with_default(self, value: Self::Output) -> ZDefault<Self>

where Self::Output: Clone,

Provide a default value when the field is missing or null.

fn refine<F>(self, check: F, message: &str) -> ZRefine<Self, F>

where F: Fn(&Self::Output) -> bool,

Add a custom refinement check without changing the output type.

fn transform<F, U>(self, f: F) -> ZTransform<Self, F, U>

where F: Fn(Self::Output) -> U,

Transform the output value after successful parsing.

fn nullish(self) -> ZNullish<Self>

Make this field nullish (both optional and nullable).

fn catch(self, fallback: Self::Output) -> ZCatch<Self>

where Self::Output: Clone,

Return a fallback value on ANY validation error.

fn pipe<S: VldSchema>(self, next: S) -> ZPipe<Self, S>

where Self::Output: Serialize,

Chain this schema’s output into another schema.

fn describe(self, description: &str) -> ZDescribe<Self>

Attach a human-readable description/label to this schema.

fn super_refine<F>(self, check: F) -> ZSuperRefine<Self, F>

where F: Fn(&Self::Output, &mut VldError),

Add a custom refinement that can produce multiple errors.

fn or<B: VldSchema>(self, other: B) -> ZUnion2<Self, B>

Create a union: this schema or another. Returns Either<Self::Output, B::Output>.

fn and<B: VldSchema>(self, other: B) -> ZIntersection<Self, B>

Create an intersection: input must satisfy both schemas.

fn message(self, msg: impl Into<String>) -> ZMessage<Self>

Override the error message for this schema.