pub enum Scalar {
Null,
Int(i64),
Float(f64),
Text(String),
Bool(bool),
Timestamp(i64),
Date(i64),
Interval {
months: i64,
days: i64,
micros: i64,
},
}Expand description
A typed scalar value — the closed set the function library speaks.
Deliberately narrower than SQL’s type zoo: kevy’s sql face maps
bigint/int → Int, double/numeric-literal → Float, text/varchar
→ Text, boolean → Bool, and SQL NULL → Null. Types the
engine refuses (money, inet, enum, …) never reach this crate.
§Examples
use kevy_scalar::{Scalar, eval};
// NULL is a value here, not an absence, and it PROPAGATES: a strict
// function with a NULL argument answers NULL rather than erroring.
assert_eq!(eval("upper", &[Scalar::Null]).unwrap(), Scalar::Null);
assert_eq!(
eval("upper", &[Scalar::Text("ada".into())]).unwrap(),
Scalar::Text("ADA".into())
);Variants§
Null
SQL NULL. Propagates: any strict function with a NULL argument answers NULL (the null-family module documents its exceptions).
Int(i64)
A 64-bit integer.
Float(f64)
A 64-bit float. PG’s numeric literals fold through here; the sql face renders results back with PG’s trailing-zero rules.
Text(String)
A UTF-8 string.
Bool(bool)
A boolean.
Timestamp(i64)
A timestamp (no time zone): microseconds since the Unix epoch.
Probe 38’s lesson is baked in: now() and friends must be
TYPED, not text — the sql face rewrites them to this variant.
Date(i64)
A calendar date: days since the Unix epoch.
Interval
An interval in PG’s three-component shape: months, days and
microseconds never mix (probe 10’s 1 day - 12 hours stays
1 day -12:00:00 — no normalization across components). Month
arithmetic clamps to month ends; the other two are exact.
Implementations§
Source§impl Scalar
impl Scalar
Sourcepub fn is_null(&self) -> bool
pub fn is_null(&self) -> bool
Whether this is SQL NULL.
§Examples
use kevy_scalar::Scalar;
assert!(Scalar::Null.is_null());
assert!(!Scalar::Int(0).is_null(), "zero is a value, not a NULL");
assert!(!Scalar::Text(String::new()).is_null(), "so is the empty string");Sourcepub fn render(&self) -> String
pub fn render(&self) -> String
PG’s text output form for this value. Null renders as the
empty string here — a caller that needs a NULL marker (the
sqllogictest runner does) checks Scalar::is_null first.
§Examples
use kevy_scalar::Scalar;
assert_eq!(Scalar::Int(42).render(), "42");
assert_eq!(Scalar::Text("ada".into()).render(), "ada");
assert_eq!(Scalar::Bool(true).render(), "t", "PG's boolean output");