Enum Value 

pub enum Value {
    Null,
    Integer(i64),
    UnsignedInteger(u64),
    Float(f64),
    Text(Arc<str>),
    Blob(Vec<u8>),
    Boolean(bool),
    Timestamp(i64),
    Duration(i64),
    IpAddr(IpAddr),
    MacAddr([u8; 6]),
    Vector(Vec<f32>),
    Json(Vec<u8>),
    Uuid([u8; 16]),
    NodeRef(String),
    EdgeRef(String),
    VectorRef(String, u64),
    RowRef(String, u64),
    Color([u8; 3]),
    Email(String),
    Url(String),
    Phone(u64),
    Semver(u32),
    Cidr(u32, u8),
    Date(i32),
    Time(u32),
    Decimal(i64),
    DecimalText(String),
    EnumValue(u8),
    Array(Vec<Value>),
    TimestampMs(i64),
    Ipv4(u32),
    Ipv6([u8; 16]),
    Subnet(u32, u32),
    Port(u16),
    Latitude(i32),
    Longitude(i32),
    GeoPoint(i32, i32),
    Country2([u8; 2]),
    Country3([u8; 3]),
    Lang2([u8; 2]),
    Lang5([u8; 5]),
    Currency([u8; 3]),
    AssetCode(String),
    Money {
        asset_code: String,
        minor_units: i64,
        scale: u8,
    },
    ColorAlpha([u8; 4]),
    BigInt(i64),
    KeyRef(String, String),
    DocRef(String, u64),
    TableRef(String),
    PageRef(u32),
    Secret(Vec<u8>),
    Password(String),
}

A typed value that can be stored in RedDB

Variants

Null

Null value

Integer(i64)

Signed 64-bit integer

UnsignedInteger(u64)

Unsigned 64-bit integer

Float(f64)

64-bit floating point

Text(Arc<str>)

UTF-8 text

Blob(Vec<u8>)

Binary data

Boolean(bool)

Boolean

Timestamp(i64)

Unix timestamp (seconds)

Duration(i64)

Duration in milliseconds

IpAddr(IpAddr)

IP address (v4 or v6)

MacAddr([u8; 6])

MAC address

Vector(Vec<f32>)

Float vector for similarity search

Json(Vec<u8>)

JSON-like structured data (stored as bytes)

Uuid([u8; 16])

UUID

NodeRef(String)

Graph node reference (node ID string)

EdgeRef(String)

Graph edge reference (edge ID string)

VectorRef(String, u64)

Vector store reference (collection, vector ID)

RowRef(String, u64)

Table row reference (table name, row ID)

Color([u8; 3])

RGB color

Email(String)

Email (stored lowercase, validated)

Url(String)

URL (validated)

Phone(u64)

Phone as digits (e.g., +5511999 -> 5511999u64)

Semver(u32)

Semantic version packed as u32

Cidr(u32, u8)

CIDR (ip as u32, prefix as u8)

Date(i32)

Date as days since Unix epoch

Time(u32)

Time as milliseconds since midnight

Decimal(i64)

Fixed-point decimal (value * 10^precision)

DecimalText(String)

Exact JSON numeric literal stored as decimal text

EnumValue(u8)

Enum variant index

Array(Vec<Value>)

Homogeneous array

TimestampMs(i64)

Timestamp in milliseconds since epoch

Ipv4(u32)

IPv4 as u32

Ipv6([u8; 16])

IPv6 as 16 bytes

Subnet(u32, u32)

Subnet: ip(u32) + mask(u32)

Port(u16)

Port number

Latitude(i32)

Latitude in microdegrees (degrees * 1_000_000)

Longitude(i32)

Longitude in microdegrees

GeoPoint(i32, i32)

GeoPoint (lat, lon) in microdegrees

Country2([u8; 2])

ISO country code 2-letter

Country3([u8; 3])

ISO country code 3-letter

Lang2([u8; 2])

Language code 2-letter

Lang5([u8; 5])

Language tag 5-char (e.g., “pt-BR”)

Currency([u8; 3])

Currency code 3-letter

AssetCode(String)

General asset code, normalized uppercase text

Money

Monetary amount stored as integer minor units plus explicit scale and asset code

Fields

asset_code: String

minor_units: i64

scale: u8

ColorAlpha([u8; 4])

RGBA color with alpha

BigInt(i64)

Big integer (same as Integer but with distinct type for schema clarity)

KeyRef(String, String)

Reference to a KV pair (collection, key)

DocRef(String, u64)

Reference to a document (collection, entity_id)

TableRef(String)

Reference to a table/collection by name

PageRef(u32)

Reference to a physical storage page (page_id)

Secret(Vec<u8>)

Encrypted secret (AES-256-GCM ciphertext bytes: nonce + ciphertext + tag)

Password(String)

Argon2id password hash string

Implementations

impl Value

pub fn text(s: impl Into<Arc<str>>) -> Self

Construct a Value::Text from anything that can produce an Arc<str> — String, &str, or an existing Arc<str>. The drop-in migration helper for the old Value::Text(String) constructor style.

pub fn data_type(&self) -> DataType

Get the data type of this value

pub fn is_null(&self) -> bool

Check if value is null

pub fn to_bytes(&self) -> Vec<u8>

Serialize value to bytes.

Delegates to super::value_codec::encode — the registry module owns every variant’s byte layout. See value_codec for the full format spec.

pub fn from_bytes(data: &[u8]) -> Result<(Self, usize), ValueError>

Deserialize value from bytes.

Delegates to super::value_codec::decode.

pub fn from_bytes_with_limit( data: &[u8], limit_bytes: usize, ) -> Result<(Self, usize), ValueError>

Admit encoded input and conservative decoded allocations before parsing. The caller must separately reserve this allowance in its shared memory pool and retain that reservation for the resulting value’s lifetime.

pub fn from_bytes_with_budget( data: &[u8], remaining_bytes: &mut usize, ) -> Result<(Self, usize), ValueError>

Decode against a caller-owned, conservative allocation allowance. A successful decode subtracts its preflight usage; failures leave it intact. This local allowance does not reserve memory in the runtime’s shared pool.

pub fn as_integer(&self) -> Option<i64>

Try to convert to i64

pub fn as_float(&self) -> Option<f64>

Try to convert to f64

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

Try to convert to string reference

pub fn as_boolean(&self) -> Option<bool>

Try to convert to bool

pub fn as_ip_addr(&self) -> Option<IpAddr>

Try to convert to IpAddr

pub fn as_vector(&self) -> Option<&[f32]>

Try to convert to vector reference

pub fn display_string(&self) -> String

Human-readable display string for rich types

pub fn plain_text(&self) -> String

Plain text coercion for string-producing SQL operators.

Unlike Display, this does not render Text as a SQL literal.

impl Value

pub fn to_json(&self) -> JsonValue

Render this value using RedDB’s canonical JSON representation.

Integers outside JavaScript’s exactly representable range and fixed-point decimals use tagged objects so no precision is lost at a JSON boundary.

Trait Implementations

impl Clone for Value

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Value

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

Formats the value using the given formatter.

impl Display for Value

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

Formats the value using the given formatter.

impl Eq for Value

Manual Eq impl: consistent with the manual Hash impl below. Float NaN is treated as equal to itself (bit-level equality) so that Value can be used in HashSet<Value> for IN-list optimizations. This diverges from IEEE 754 but is safe for SQL query evaluation.

impl From<&str> for Value

fn from(s: &str) -> Self

Converts to this type from the input type.

impl From<String> for Value

fn from(s: String) -> Self

Converts to this type from the input type.

impl From<bool> for Value

fn from(b: bool) -> Self

Converts to this type from the input type.

impl From<f32> for Value

fn from(n: f32) -> Self

Converts to this type from the input type.

impl From<f64> for Value

fn from(n: f64) -> Self

Converts to this type from the input type.

impl From<i32> for Value

fn from(n: i32) -> Self

Converts to this type from the input type.

impl From<i64> for Value

fn from(n: i64) -> Self

Converts to this type from the input type.

impl Hash for Value

Manual Hash impl for Value.

• Floats: use f64.to_bits() so the invariant a == b → hash(a) == hash(b) holds.
• Arrays / nested values: hash each element recursively.
• All other variants: delegate to the byte-level representation.

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for Value

fn eq(&self, other: &Self) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl StructuralPartialEq for Value