Enum Value 

pub enum Value {
    Empty,
    Null(NullType),
    Bool(bool),
    SmallInt(i16),
    Int(i32),
    BigInt(i64),
    Float(f32),
    Double(f64),
    Decimal128(Decimal128Value),
    String(CompactString),
    FixedString(String),
    Blob(Vec<u8>),
    Date(DateValue),
    Time(TimeValue),
    DateTime(DateTimeValue),
    Vertex(Box<Vertex>),
    Edge(Box<Edge>),
    EdgeHeader(Box<EdgeHeader>),
    Path(Box<Path>),
    List(Box<List>),
    Map(Box<HashMap<Value, Value>>),
    Set(Box<HashSet<Value>>),
    Geography(Geography),
    Vector(VectorValue),
    DataSet(Box<DataSet>),
    Json(Box<Json>),
    JsonB(Box<JsonB>),
    Uuid(UuidValue),
    Interval(IntervalValue),
    VertexId(VertexId),
    EdgeId(EdgeId),
    Struct(Box<StructValue>),
    Array(Box<ArrayValue>),
}

Indicates values that can be stored in node/edge attributes Simplified design following PostgreSQL type system

Variants

Empty

Null(NullType)

Bool(bool)

SmallInt(i16)

Int(i32)

BigInt(i64)

Float(f32)

Double(f64)

Decimal128(Decimal128Value)

String(CompactString)

FixedString(String)

Fixed-length strings for optimized storage of short strings. Content is always padded/truncated to the declared length, so the length is derivable via chars().count().

Blob(Vec<u8>)

Binary data

Date(DateValue)

Time(TimeValue)

DateTime(DateTimeValue)

Vertex(Box<Vertex>)

Edge(Box<Edge>)

EdgeHeader(Box<EdgeHeader>)

Path(Box<Path>)

List(Box<List>)

Map(Box<HashMap<Value, Value>>)

Map with generalized keys: any hashable Value (string keys remain the common case; float keys use the normalized NaN/±0 hashing).

Set(Box<HashSet<Value>>)

Geography(Geography)

Vector(VectorValue)

DataSet(Box<DataSet>)

Json(Box<Json>)

JSON type (text format)

JsonB(Box<JsonB>)

JSONB type (binary format)

Uuid(UuidValue)

UUID type (16 bytes binary)

Interval(IntervalValue)

Interval type (PostgreSQL compatible)

VertexId(VertexId)

Lightweight vertex ID reference (no heap allocation). Used by expand fast path when only the vertex ID is needed (e.g. count-only aggregation downstream).

EdgeId(EdgeId)

Lightweight edge ID reference (no heap allocation). Used by expand fast path when only the edge ID is needed.

Struct(Box<StructValue>)

STRUCT value: ordered named fields.

Array(Box<ArrayValue>)

ARRAY value: element-homogeneous array.

Implementations

impl Value

pub fn add(&self, other: &Value) -> Result<Value, String>

Addition operation

pub fn sub(&self, other: &Value) -> Result<Value, String>

Subtraction operation

pub fn mul(&self, other: &Value) -> Result<Value, String>

Multiplication operation

pub fn div(&self, other: &Value) -> Result<Value, String>

Division operation

pub fn rem(&self, other: &Value) -> Result<Value, String>

Modular operation

pub fn pow(&self, other: &Value) -> Result<Value, String>

Power operation

pub fn neg(&self) -> Result<Value, String>

Negation operation

pub fn and(&self, other: &Value) -> Result<Value, String>

Logic and Operations

pub fn or(&self, other: &Value) -> Result<Value, String>

Logical OR operation

pub fn not(&self) -> Result<Value, String>

Logical NOT operation

pub fn bit_and(&self, other: &Value) -> Result<Value, String>

Bitwise AND operation

pub fn bit_or(&self, other: &Value) -> Result<Value, String>

Bitwise OR operation

pub fn bit_xor(&self, other: &Value) -> Result<Value, String>

Bitwise XOR operation

pub fn bit_shl(&self, other: &Value) -> Result<Value, String>

Left shift operation

pub fn bit_shr(&self, other: &Value) -> Result<Value, String>

Right-shift operation

pub fn bit_not(&self) -> Result<Value, String>

Bitwise NOT operation

pub fn abs(&self) -> Result<Value, String>

Absolute value operation

pub fn len(&self) -> Result<Value, String>

Get the length of a value (for strings, lists, maps, sets)

impl Value

pub fn to_bool(&self) -> Value

Convert to a boolean value

pub fn to_int(&self) -> Value

Convert to BigInt (i64)

pub fn to_float(&self) -> Value

Convert to Double (f64)

pub fn to_string(&self) -> Result<String, String>

Convert to string

pub fn to_list(&self) -> Value

Convert to a list

pub fn to_map(&self) -> Value

Convert to a map:

pub fn to_set(&self) -> Value

Convert to a set

pub fn to_date(&self) -> Value

Convert to a date

pub fn to_time(&self) -> Value

Convert to time

pub fn to_datetime(&self) -> Value

Convert to date and time

pub fn to_interval(&self) -> Value

Convert to interval

pub fn try_implicit_cast(&self, target_type: &DataType) -> Result<Value, String>

Try to implicitly convert to the specified type.

pub fn to_smallint(&self) -> Value

Convert to SmallInt (i16)

pub fn to_int32(&self) -> Value

Convert to Int (i32)

pub fn to_float32(&self) -> Value

Convert to Float (f32)

pub fn can_implicitly_cast_to(&self, target_type: &DataType) -> bool

Check whether an implicit conversion is possible.

pub fn is_valid_number(&self) -> bool

Check whether the value is a valid number.

pub fn is_valid_date(&self) -> bool

Check whether the value is a valid date.

pub fn is_valid_time(&self) -> bool

Check whether the value represents a valid time.

pub fn is_valid_datetime(&self) -> bool

Check whether the value is a valid date and time.

impl Value

pub fn to_uuid(&self) -> Value

Convert to UUID

pub fn try_cast_to(&self, target: &DataType) -> Result<Value, StorageError>

Try to cast this value to the target data type. Returns the converted value on success, or a type_mismatch error. Supports implicit type conversions that are allowed by TypeUtils::can_cast.

impl Value

pub fn string(s: impl AsRef<str>) -> Value

Create a string value from a string-like type.

CompactString stores up to 22 bytes inline without heap allocation, falling back to a heap-allocated String for longer content.

pub fn string_from_owned(s: String) -> Value

Create a string value from an owned String.

pub fn get_type(&self) -> DataType

Getting the type of value

pub fn data_type(&self) -> DataType

Alias for get_type

pub fn container_element_type<'a, I>(elements: I) -> DataType

where I: IntoIterator<Item = &'a Value>,

Common type of a container’s elements.

Folds Value::get_type over the element types with the numeric/temporal promotion hierarchy. Returns DataType::Empty for an empty container (the “untyped container” marker on the parameterized List/Map/Set variants).

pub fn is_null(&self) -> bool

Check if the value is null

pub fn is_numeric(&self) -> bool

Check if the value is a numeric type

pub fn is_bad_null(&self) -> bool

Check if the value is BadNull

pub fn is_empty(&self) -> bool

Check if the value is empty

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

Get Boolean value

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

Get String value

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

Get vector value as Vec from List of Float values or Vector type

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

Get reference to vector data (more efficient than as_vector)

pub fn vector(data: Vec<f32>) -> Value

Create a new vector value

pub fn sparse_vector(indices: Vec<u32>, values: Vec<f32>) -> Value

Create a new sparse vector value

pub fn fixed_string(len: usize, data: String) -> Value

Create fixed-length string value (truncates or space-pads to len)

pub fn fixed_string_len(&self) -> Option<usize>

Get the length of a fixed-length string

pub fn hash_value(&self) -> u64

Compute the hash of the value

pub fn estimated_size(&self) -> usize

Estimate the memory usage of the value

pub fn json(text: &str) -> Result<Value, JsonError>

Create JSON value

pub fn jsonb(text: &str) -> Result<Value, JsonError>

Create JSONB value

pub fn from_json_value(value: Value) -> Value

Create JSON value from serde_json::Value

impl Value

pub fn list(list: List) -> Value

Create a new List value (wraps in Box)

pub fn map(map: HashMap<Value, Value>) -> Value

Create a new Map value (wraps in Box).

pub fn string_map<K>(map: impl IntoIterator<Item = (K, Value)>) -> Value

where K: AsRef<str>,

Create a new Map value from string-keyed entries (the common case).

pub fn set(set: HashSet<Value>) -> Value

Create a new Set value (wraps in Box)

pub fn edge(edge: Edge) -> Value

Create a new Edge value (wraps in Box)

pub fn edge_header(header: EdgeHeader) -> Value

Create a new edge header value (wraps in Box)

pub fn path(path: Path) -> Value

Create a new Path value (wraps in Box)

pub fn dataset(dataset: DataSet) -> Value

Create a new DataSet value (wraps in Box)

pub fn struct_(fields: Vec<(String, Value)>) -> Value

Create a new Struct value (wraps in Box).

pub fn array(values: Vec<Value>) -> Value

Create a new Array value (wraps in Box).

Trait Implementations

impl Clone for Value

fn clone(&self) -> Value

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<(), Error>

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for Value

fn deserialize<__D>( __deserializer: __D, ) -> Result<Value, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for Value

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

Formats the value using the given formatter.

impl Eq for Value

impl From<&Value> for IntersectKey

fn from(value: &Value) -> Self

Converts to this type from the input type.

impl From<&str> for Value

fn from(value: &str) -> Value

Converts to this type from the input type.

impl From<(i64, &str)> for Value

fn from(value: (i64, &str)) -> Value

Converts to this type from the input type.

impl From<(i64, String)> for Value

fn from(value: (i64, String)) -> Value

Converts to this type from the input type.

impl From<HashMap<String, Value>> for Value

fn from(value: HashMap<String, Value>) -> Value

Converts to this type from the input type.

impl From<HashMap<Value, Value>> for Value

fn from(value: HashMap<Value, Value>) -> Value

Converts to this type from the input type.

impl From<HashSet<Value>> for Value

fn from(value: HashSet<Value>) -> Value

Converts to this type from the input type.

impl From<IntervalValue> for Value

fn from(value: IntervalValue) -> Value

Converts to this type from the input type.

impl From<NullType> for Value

fn from(value: NullType) -> Value

Converts to this type from the input type.

impl From<String> for Value

fn from(value: String) -> Value

Converts to this type from the input type.

impl From<UuidValue> for Value

fn from(value: UuidValue) -> Value

Converts to this type from the input type.

impl From<Value> for JoinKeyValue

fn from(value: Value) -> Self

Converts to this type from the input type.

impl From<Vec<Value>> for Value

fn from(value: Vec<Value>) -> Value

Converts to this type from the input type.

impl From<VertexId> for Value

fn from(vid: VertexId) -> Value

Converts to this type from the input type.

impl From<bool> for Value

fn from(value: bool) -> Value

Converts to this type from the input type.

impl From<f32> for Value

fn from(value: f32) -> Value

Converts to this type from the input type.

impl From<f64> for Value

fn from(value: f64) -> Value

Converts to this type from the input type.

impl From<i16> for Value

fn from(value: i16) -> Value

Converts to this type from the input type.

impl From<i32> for Value

fn from(value: i32) -> Value

Converts to this type from the input type.

impl From<i64> for Value

fn from(value: i64) -> Value

Converts to this type from the input type.

impl Hash for Value

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

where H: Hasher,

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 MemoryEstimatable for Value

fn estimate_memory(&self) -> usize

impl Ord for Value

fn cmp(&self, other: &Value) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

fn clamp_to<R>(self, range: R) -> Self

where Self: Sized, R: ClampBounds<Self>,

🔬This is a nightly-only experimental API. (clamp_to)

Restrict a value to a certain range.

impl PartialEq for Value

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

Equality operator ==.

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

Inequality operator !=.

impl PartialOrd for Value

fn partial_cmp(&self, other: &Value) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for Value

fn serialize<__S>( &self, __serializer: __S, ) -> Result<<__S as Serializer>::Ok, <__S as Serializer>::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.