Struct ScalarValue

pub struct ScalarValue(/* private fields */);

Represents the internal data of a scalar value. Must be interpreted by wrapping up with a DType to make a super::Scalar.

Note that these values can be deserialized from JSON or other formats. So a PValue may not have the correct width for what the DType expects. Primitive values should therefore be read using super::PrimitiveScalar which will handle the conversion.

Implementations

impl ScalarValue

pub fn to_protobytes<B: BufMut + Default>(&self) -> B

Serializes the scalar value to Protocol Buffers format.

pub fn from_protobytes(buf: &[u8]) -> VortexResult<Self>

Deserializes a scalar value from Protocol Buffers format.

impl ScalarValue

pub const fn null() -> Self

Creates a null scalar value.

pub fn is_null(&self) -> bool

Returns true if this is a null value.

pub fn is_instance_of(&self, dtype: &DType) -> bool

Returns true if this value is compatible with the given data type.

Trait Implementations

impl Clone for ScalarValue

fn clone(&self) -> ScalarValue

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ScalarValue

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

Formats the value using the given formatter.

impl Display for ScalarValue

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

Formats the value using the given formatter.

impl From<&[u8]> for ScalarValue

fn from(value: &[u8]) -> Self

Converts to this type from the input type.

impl From<&ScalarValue> for ScalarValue

fn from(value: &ScalarValue) -> Self

Converts to this type from the input type.

impl From<&str> for ScalarValue

fn from(value: &str) -> Self

Converts to this type from the input type.

impl From<Buffer<u8>> for ScalarValue

fn from(value: ByteBuffer) -> Self

Converts to this type from the input type.

impl From<BufferString> for ScalarValue

fn from(value: BufferString) -> Self

Converts to this type from the input type.

impl From<DecimalValue> for ScalarValue

fn from(value: DecimalValue) -> Self

Converts to this type from the input type.

impl<T> From<Option<T>> for ScalarValue

where T: ScalarType, ScalarValue: From<T>,

fn from(value: Option<T>) -> Self

Converts to this type from the input type.

impl From<PValue> for ScalarValue

fn from(value: PValue) -> Self

Converts to this type from the input type.

impl From<String> for ScalarValue

fn from(value: String) -> Self

Converts to this type from the input type.

impl From<Vec<Buffer<u8>>> for ScalarValue

fn from(value: Vec<ByteBuffer>) -> Self

Converts to this type from the input type.

impl From<Vec<BufferString>> for ScalarValue

fn from(value: Vec<BufferString>) -> Self

Converts to this type from the input type.

impl From<Vec<String>> for ScalarValue

fn from(value: Vec<String>) -> Self

Converts to this type from the input type.

impl From<Vec<f16>> for ScalarValue

fn from(value: Vec<f16>) -> Self

Converts to this type from the input type.

impl From<Vec<f32>> for ScalarValue

fn from(value: Vec<f32>) -> Self

Converts to this type from the input type.

impl From<Vec<f64>> for ScalarValue

fn from(value: Vec<f64>) -> Self

Converts to this type from the input type.

impl From<Vec<i16>> for ScalarValue

fn from(value: Vec<i16>) -> Self

Converts to this type from the input type.

impl From<Vec<i32>> for ScalarValue

fn from(value: Vec<i32>) -> Self

Converts to this type from the input type.

impl From<Vec<i64>> for ScalarValue

fn from(value: Vec<i64>) -> Self

Converts to this type from the input type.

impl From<Vec<i8>> for ScalarValue

fn from(value: Vec<i8>) -> Self

Converts to this type from the input type.

impl From<Vec<u16>> for ScalarValue

fn from(value: Vec<u16>) -> Self

Converts to this type from the input type.

impl From<Vec<u32>> for ScalarValue

fn from(value: Vec<u32>) -> Self

Converts to this type from the input type.

impl From<Vec<u64>> for ScalarValue

fn from(value: Vec<u64>) -> Self

Converts to this type from the input type.

impl From<Vec<usize>> for ScalarValue

fn from(value: Vec<usize>) -> Self

Converts to this type from the input type.

impl From<bool> for ScalarValue

fn from(value: bool) -> Self

Converts to this type from the input type.

impl From<f16> for ScalarValue

fn from(value: f16) -> Self

Converts to this type from the input type.

impl From<f32> for ScalarValue

fn from(value: f32) -> Self

Converts to this type from the input type.

impl From<f64> for ScalarValue

fn from(value: f64) -> Self

Converts to this type from the input type.

impl From<i16> for ScalarValue

fn from(value: i16) -> Self

Converts to this type from the input type.

impl From<i32> for ScalarValue

fn from(value: i32) -> Self

Converts to this type from the input type.

impl From<i64> for ScalarValue

fn from(value: i64) -> Self

Converts to this type from the input type.

impl From<i8> for ScalarValue

fn from(value: i8) -> Self

Converts to this type from the input type.

impl From<u16> for ScalarValue

fn from(value: u16) -> Self

Converts to this type from the input type.

impl From<u32> for ScalarValue

fn from(value: u32) -> Self

Converts to this type from the input type.

impl From<u64> for ScalarValue

fn from(value: u64) -> Self

Converts to this type from the input type.

impl From<u8> for ScalarValue

fn from(value: u8) -> Self

Converts to this type from the input type.

impl From<usize> for ScalarValue

Read a scalar as usize. For usize only, we implicitly cast for better ergonomics.

fn from(value: usize) -> Self

Converts to this type from the input type.

impl TryFrom<&ScalarValue> for ScalarValue

type Error = VortexError

The type returned in the event of a conversion error.

fn try_from(value: &ScalarValue) -> Result<Self, Self::Error>

Performs the conversion.