Struct ZInteger 

pub struct ZInteger<T>
where
    T: IntType,
{ /* private fields */ }

Schema for a sized integer (i8..u64, isize, usize). Created via vld::i8() … vld::u64(); ZInt (vld::number().int()) is ZInteger<i64>.

Integers are read exactly (no f64 round-trip; u64 values above i64::MAX included). Floats with a fraction fail with not_int; values outside the type’s range fail with too_small / too_big (origin number) naming the type’s bound.

JSON Schema: {"type": "integer", "format": "int8" … "uint64"} with minimum / maximum from the type range intersected with the user bounds.

Example

use vld::prelude::*;

let port: u16 = vld::u16().min(1).parse("8080").unwrap();
assert_eq!(port, 8080);
assert!(vld::u16().parse("70000").is_err()); // above u16::MAX
assert!(vld::u8().parse("-1").is_err());
assert!(vld::i32().parse("1.5").is_err());
assert_eq!(vld::u64().parse("18446744073709551615").unwrap(), u64::MAX);

Implementations

impl<T> ZInteger<T>

where T: IntType,

pub fn new() -> ZInteger<T>

Create the schema (the same as its vld:: constructor function).

pub fn type_error(self, msg: impl Into<String>) -> ZInteger<T>

Set a custom error message for type mismatch (non-number input).

pub fn int_error(self, msg: impl Into<String>) -> ZInteger<T>

Set a custom error message for when the number is not an integer.

Example

use vld::prelude::*;
let schema = vld::number().int().int_error("Whole numbers only!");
let err = schema.parse("3.5").unwrap_err();
assert!(err.issues[0].message.contains("Whole numbers only!"));

pub fn with_messages<F>(self, f: F) -> ZInteger<T>

where F: Fn(&str) -> Option<String> + Send + Sync + 'static,

Override error messages in bulk by check key.

Same keys as ZNumber::with_messages, plus "not_int" for the integer check itself.

pub fn coerce(self) -> ZInteger<T>

Coerce strings ("42") and booleans to integers.

pub fn min(self, val: T) -> ZInteger<T>

Minimum value (inclusive).

pub fn max(self, val: T) -> ZInteger<T>

Maximum value (inclusive).

pub fn gt(self, val: T) -> ZInteger<T>

Greater than (exclusive).

pub fn gte(self, val: T) -> ZInteger<T>

Greater than or equal (inclusive). Same as min.

pub fn lt(self, val: T) -> ZInteger<T>

Less than (exclusive).

pub fn lte(self, val: T) -> ZInteger<T>

Less than or equal (inclusive). Same as max.

pub fn positive(self) -> ZInteger<T>

Must be positive (> 0).

pub fn negative(self) -> ZInteger<T>

Must be negative (< 0).

pub fn non_negative(self) -> ZInteger<T>

Must be non-negative (>= 0).

pub fn non_positive(self) -> ZInteger<T>

Must be non-positive (<= 0).

pub fn safe(self) -> ZInteger<T>

Must be within JavaScript’s safe integer range.

pub fn multiple_of(self, val: T) -> ZInteger<T>

Must be a multiple of the given value (0 never matches).

Trait Implementations

impl<T> Clone for ZInteger<T>

where T: IntType,

fn clone(&self) -> ZInteger<T>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<T> Default for ZInteger<T>

where T: IntType,

fn default() -> ZInteger<T>

Returns the “default value” for a type.

impl<T> VldSchema for ZInteger<T>

where T: IntType,

type Output = T

The Rust type produced by this schema after successful parsing.

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

Parse and validate a serde_json::Value.

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

where I: VldInput + ?Sized,

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

fn validate<T>(&self, value: &T) -> Result<Self::Output, VldError>

where T: Serialize,

Validate an existing Rust value against this schema.

fn is_valid<T>(&self, value: &T) -> bool

where T: Serialize,

Check if an existing Rust value passes this schema’s validation.

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>(self, next: S) -> ZPipe<Self, S>

where S: VldSchema, 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>(self, other: B) -> ZUnion2<Self, B>

where B: VldSchema,

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

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

where B: VldSchema,

Create an intersection: input must satisfy both schemas.

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

Override the error message for this schema.