Enum MultiValues

Source

pub enum MultiValues {
Show 28 variants
    Empty(DataType),
    Bool(Vec<bool>),
    Char(Vec<char>),
    Int8(Vec<i8>),
    Int16(Vec<i16>),
    Int32(Vec<i32>),
    Int64(Vec<i64>),
    Int128(Vec<i128>),
    UInt8(Vec<u8>),
    UInt16(Vec<u16>),
    UInt32(Vec<u32>),
    UInt64(Vec<u64>),
    UInt128(Vec<u128>),
    IntSize(Vec<isize>),
    UIntSize(Vec<usize>),
    Float32(Vec<f32>),
    Float64(Vec<f64>),
    BigInteger(Vec<BigInt>),
    BigDecimal(Vec<BigDecimal>),
    String(Vec<String>),
    Date(Vec<NaiveDate>),
    Time(Vec<NaiveTime>),
    DateTime(Vec<NaiveDateTime>),
    Instant(Vec<DateTime<Utc>>),
    Duration(Vec<Duration>),
    Url(Vec<Url>),
    StringMap(Vec<HashMap<String, String>>),
    Json(Vec<Value>),
}

Expand description

Multiple values container

Uses an enum to represent multiple values of different types, providing type-safe storage and access for multiple values.

§Features

Supports collections of multiple basic data types.
Provides two sets of APIs for type checking and type conversion.
Supports unified access to single and multiple values.
Automatic memory management.

§Example

use qubit_value::MultiValues;

// Create integer multiple values
let mut values = MultiValues::Int32(vec![1, 2, 3]);
assert_eq!(values.count(), 3);
assert_eq!(values.get_first_int32().unwrap(), 1);

// Get all values
let all = values.get_int32s().unwrap();
assert_eq!(all, &[1, 2, 3]);

// Use generic method to add value
values.add(4).unwrap();
assert_eq!(values.count(), 4);

StringMap list

§

Implementations§

Source §

impl MultiValues

Source

pub fn add_bool(&mut self, value: bool) -> ValueResult<()>

Add a boolean value

§Parameters

value - The boolean value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Example

use qubit_value::MultiValues;

let mut values = MultiValues::Bool(vec![true]);
values.add_bool(false).unwrap();
assert_eq!(values.count(), 2);

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_char(&mut self, value: char) -> ValueResult<()>

Add a character value

§Parameters

value - The character value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_int8(&mut self, value: i8) -> ValueResult<()>

Add an int8 value

§Parameters

value - The int8 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_int16(&mut self, value: i16) -> ValueResult<()>

Add an int16 value

§Parameters

value - The int16 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_int32(&mut self, value: i32) -> ValueResult<()>

Add an int32 value

§Parameters

value - The int32 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_int64(&mut self, value: i64) -> ValueResult<()>

Add an int64 value

§Parameters

value - The int64 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_int128(&mut self, value: i128) -> ValueResult<()>

Add an int128 value

§Parameters

value - The int128 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_uint8(&mut self, value: u8) -> ValueResult<()>

Add a uint8 value

§Parameters

value - The uint8 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_uint16(&mut self, value: u16) -> ValueResult<()>

Add a uint16 value

§Parameters

value - The uint16 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_uint32(&mut self, value: u32) -> ValueResult<()>

Add a uint32 value

§Parameters

value - The uint32 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_uint64(&mut self, value: u64) -> ValueResult<()>

Add a uint64 value

§Parameters

value - The uint64 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_uint128(&mut self, value: u128) -> ValueResult<()>

Add a uint128 value

§Parameters

value - The uint128 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_float32(&mut self, value: f32) -> ValueResult<()>

Add a float32 value

§Parameters

value - The float32 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_float64(&mut self, value: f64) -> ValueResult<()>

Add a float64 value

§Parameters

value - The float64 value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_string(&mut self, value: String) -> ValueResult<()>

Add a string

§Parameters

value - The string to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_date(&mut self, value: NaiveDate) -> ValueResult<()>

Add a date value

§Parameters

value - The date value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_time(&mut self, value: NaiveTime) -> ValueResult<()>

Add a time value

§Parameters

value - The time value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_datetime(&mut self, value: NaiveDateTime) -> ValueResult<()>

Add a datetime value

§Parameters

value - The datetime value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_instant(&mut self, value: DateTime<Utc>) -> ValueResult<()>

Add a UTC instant value

§Parameters

value - The UTC instant value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_biginteger(&mut self, value: BigInt) -> ValueResult<()>

Add a big integer value

§Parameters

value - The big integer value to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the value being appended.

Source

pub fn add_bigdecimal(&mut self, value: BigDecimal) -> ValueResult<()>

Add a big decimal value

§Parameters

value - The big decimal value to add

pub fn add_bools(&mut self, values: Vec<bool>) -> ValueResult<()>

Add multiple boolean values

§Parameters

values - The list of boolean values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Example

use qubit_value::MultiValues;

let mut values = MultiValues::Bool(vec![true]);
values.add_bools(vec![false, true]).unwrap();
assert_eq!(values.get_bools().unwrap(), &[true, false, true]);

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_chars(&mut self, values: Vec<char>) -> ValueResult<()>

Add multiple character values

§Parameters

values - The list of character values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_int8s(&mut self, values: Vec<i8>) -> ValueResult<()>

Add multiple int8 values

§Parameters

values - The list of int8 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_int16s(&mut self, values: Vec<i16>) -> ValueResult<()>

Add multiple int16 values

§Parameters

values - The list of int16 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_int32s(&mut self, values: Vec<i32>) -> ValueResult<()>

Add multiple int32 values

§Parameters

values - The list of int32 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_int64s(&mut self, values: Vec<i64>) -> ValueResult<()>

Add multiple int64 values

§Parameters

values - The list of int64 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_int128s(&mut self, values: Vec<i128>) -> ValueResult<()>

Add multiple int128 values

§Parameters

values - The list of int128 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_uint8s(&mut self, values: Vec<u8>) -> ValueResult<()>

Add multiple uint8 values

§Parameters

values - The list of uint8 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_uint16s(&mut self, values: Vec<u16>) -> ValueResult<()>

Add multiple uint16 values

§Parameters

values - The list of uint16 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_uint32s(&mut self, values: Vec<u32>) -> ValueResult<()>

Add multiple uint32 values

§Parameters

values - The list of uint32 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_uint64s(&mut self, values: Vec<u64>) -> ValueResult<()>

Add multiple uint64 values

§Parameters

values - The list of uint64 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_uint128s(&mut self, values: Vec<u128>) -> ValueResult<()>

Add multiple uint128 values

§Parameters

values - The list of uint128 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_float32s(&mut self, values: Vec<f32>) -> ValueResult<()>

Add multiple float32 values

§Parameters

values - The list of float32 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_float64s(&mut self, values: Vec<f64>) -> ValueResult<()>

Add multiple float64 values

§Parameters

values - The list of float64 values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_strings(&mut self, values: Vec<String>) -> ValueResult<()>

Add multiple string values

§Parameters

values - The list of string values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Example

use qubit_value::MultiValues;

let mut values = MultiValues::String(vec!["hello".to_string()]);
values.add_strings(vec!["world".to_string(), "rust".to_string()]).unwrap();
assert_eq!(values.get_strings().unwrap(), &["hello", "world", "rust"]);

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_dates(&mut self, values: Vec<NaiveDate>) -> ValueResult<()>

Add multiple date values

§Parameters

values - The list of date values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_times(&mut self, values: Vec<NaiveTime>) -> ValueResult<()>

Add multiple time values

§Parameters

values - The list of time values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_datetimes(&mut self, values: Vec<NaiveDateTime>) -> ValueResult<()>

Add multiple datetime values

§Parameters

values - The list of datetime values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_instants(&mut self, values: Vec<DateTime<Utc>>) -> ValueResult<()>

Add multiple UTC instant values

§Parameters

values - The list of UTC instant values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_bigintegers(&mut self, values: Vec<BigInt>) -> ValueResult<()>

Add multiple big integer values

§Parameters

values - The list of big integer values to add

§Returns

If types match, returns Ok(()); see # Errors.

§Errors

Returns ValueError::TypeMismatch when the current stored data type differs from the values being appended.

Source

pub fn add_bigdecimals(&mut self, values: Vec<BigDecimal>) -> ValueResult<()>

Add multiple big decimal values

§Parameters

values - The list of big decimal values to add

§Type Parameters

T - Target type.

§Returns

The converted first value.

§Errors

Returns ValueError::NoValue when no value is stored, or a conversion error when the first value cannot be converted to T.

Source

pub fn to_or<T>(&self, default: impl IntoValueDefault<T>) -> ValueResult<T>
where for<'a> DataConverter<'a>: DataConvertTo<T>,

Converts the first stored value to T, or returns default when no value is stored.

Source

pub fn to_with<T>(&self, options: &DataConversionOptions) -> ValueResult<T>
where for<'a> DataConverter<'a>: DataConvertTo<T>,

Converts the first stored value to T using conversion options.

A MultiValues::String containing exactly one string is treated as a scalar string source, so collection options can split it before taking the first converted item. Multiple stored string values are treated as an already-materialized list and are converted element by element.

§Type Parameters

T - Target type.

§Parameters

options - Conversion options forwarded to qubit_datatype.

§Returns

The converted first value.

§Errors

Returns ValueError::NoValue when no value is stored, or a conversion error when the first value cannot be converted to T.

Source

pub fn to_or_with<T>( &self, default: impl IntoValueDefault<T>, options: &DataConversionOptions, ) -> ValueResult<T>
where for<'a> DataConverter<'a>: DataConvertTo<T>,

Converts the first stored value to T using conversion options, or returns default when no value is stored.

Source

pub fn to_list<T>(&self) -> ValueResult<Vec<T>>
where for<'a> DataConverter<'a>: DataConvertTo<T>,

Converts all stored values to T.

Unlike Self::get, this method uses shared DataConverter conversion rules for every element instead of strict type matching. Empty values return an empty vector.

§Type Parameters

T - Target element type.

§Returns

A vector containing all converted values in the original order.

§Errors

Returns the first conversion error encountered while converting an element.

Source

pub fn to_list_or<T>( &self, default: impl IntoValueDefault<Vec<T>>, ) -> ValueResult<Vec<T>>
where for<'a> DataConverter<'a>: DataConvertTo<T>,

Converts all stored values to T, or returns default when the converted list is empty.

Source

pub fn to_list_with<T>( &self, options: &DataConversionOptions, ) -> ValueResult<Vec<T>>
where for<'a> DataConverter<'a>: DataConvertTo<T>,

Converts all stored values to T using conversion options.

A MultiValues::String containing exactly one string is treated as a scalar string source, so collection options can split it into items. Multiple stored string values are treated as an already-materialized list and are converted element by element.

§Type Parameters

T - Target element type.

§Parameters

options - Conversion options forwarded to qubit_datatype.

other - The multiple values to merge

§Returns

Returns Ok(()) after appending all values from other.

§Errors

Returns ValueError::TypeMismatch when other has a different data type from this container.

§Example

use qubit_value::MultiValues;

let mut a = MultiValues::Int32(vec![1, 2]);
let b = MultiValues::Int32(vec![3, 4]);
a.merge(&b).unwrap();
assert_eq!(a.get_int32s().unwrap(), &[1, 2, 3, 4]);

Source §

impl MultiValues

Source

pub fn new<S>(values: S) -> Self
where S: Into<Self>,

Generic constructor method

Creates MultiValues from any supported input form, avoiding direct use of enum variants at call sites.

Supported input forms include single values, vectors, slices, arrays, borrowed vectors, and borrowed string collections for supported element types.

§Type Parameters

S - Input type convertible into MultiValues.

§Returns

Returns MultiValues wrapping the converted input values.

§Example

use qubit_value::MultiValues;

// Basic types
let mv = MultiValues::new(vec![1, 2, 3]);
assert_eq!(mv.count(), 3);

// Strings
let mv = MultiValues::new(vec!["a".to_string(), "b".to_string()]);
assert_eq!(mv.count(), 2);

Source

pub fn get<T>(&self) -> ValueResult<Vec<T>>
where for<'a> Vec<T>: TryFrom<&'a Self, Error = ValueError>,

Generic getter method for multiple values.

Performs a strict typed read of all stored values as Vec<T>.

§Type Parameters

T - The target element type to retrieve.

§Returns

Returns the list of values when the stored type matches T.

§Errors

Returns ValueError::TypeMismatch when the stored type differs from T.

§Example

use qubit_value::MultiValues;

let multi = MultiValues::Int32(vec![1, 2, 3]);

// Through type inference
let nums: Vec<i32> = multi.get().unwrap();
assert_eq!(nums, vec![1, 2, 3]);

// Explicitly specify type parameter
let nums = multi.get::<i32>().unwrap();
assert_eq!(nums, vec![1, 2, 3]);

Source

pub fn get_or<T>( &self, default: impl IntoValueDefault<Vec<T>>, ) -> ValueResult<Vec<T>>
where for<'a> Vec<T>: TryFrom<&'a Self, Error = ValueError>,

Generic getter method with a default value list.

Returns the supplied default only when the stored list is empty. Type mismatches are still returned as errors.

Source

pub fn get_first<T>(&self) -> ValueResult<T>
where for<'a> T: TryFrom<&'a Self, Error = ValueError>,

Generic getter method for the first value

Reads the first stored value as T, performing strict type checking.

get_first<T>() does not do cross-type conversion. Use Self::to if conversion between compatible data types is desired.

§Type Parameters

T - The target element type to retrieve.

§Returns

Returns the first value when the stored type matches T and at least one value exists.

§Errors

Returns ValueError::NoValue when the requested type matches but no value is stored, or ValueError::TypeMismatch when the stored type differs from T.

§Example

use qubit_value::MultiValues;

let multi = MultiValues::Int32(vec![42, 100, 200]);

// Through type inference
let first: i32 = multi.get_first().unwrap();
assert_eq!(first, 42);

// Explicitly specify type parameter
let first = multi.get_first::<i32>().unwrap();
assert_eq!(first, 42);

// String type
let multi = MultiValues::String(vec!["hello".to_string(), "world".to_string()]);
let first: String = multi.get_first().unwrap();
assert_eq!(first, "hello");

Source

pub fn get_first_or<T>( &self, default: impl IntoValueDefault<T>, ) -> ValueResult<T>
where for<'a> T: TryFrom<&'a Self, Error = ValueError>,

Generic first-value getter with a default value.

Returns the supplied default only when no first value exists. Type mismatches are still returned as errors.

Source

pub fn set<S>(&mut self, values: S) -> ValueResult<()>
where S: Into<Self>,

Generic setter method

Replaces the entire list with the converted input values.

This operation updates the stored type to the input element type and does not validate runtime compatibility with the previous variant.

Supports any input that can be converted into MultiValues, including single values, vectors, slices, arrays, and borrowed vectors for supported element types.

Existing values are replaced, and the stored type becomes the converted input type.

§Type Parameters

S - Input type convertible into MultiValues.

§Parameters

values - The values to set.

§Returns

Always returns Ok(()) for supported input types. Unsupported input types fail to compile because they do not implement Into<MultiValues>.

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

// 1) Vec<T>
let mut mv = MultiValues::Empty(DataType::Int32);
mv.set(vec![42, 100, 200]).unwrap();
assert_eq!(mv.get_int32s().unwrap(), &[42, 100, 200]);

// 2) &[T]
let mut mv = MultiValues::Empty(DataType::Int32);
let slice = &[7, 8, 9][..];
mv.set(slice).unwrap();
assert_eq!(mv.get_int32s().unwrap(), &[7, 8, 9]);

// 3) Single T
let mut mv = MultiValues::Empty(DataType::Int32);
mv.set(42).unwrap();
assert_eq!(mv.get_int32s().unwrap(), &[42]);

// String example
let mut mv = MultiValues::Empty(DataType::String);
mv.set(vec!["hello".to_string(), "world".to_string()]).unwrap();
assert_eq!(mv.get_strings().unwrap(), &["hello", "world"]);

Source

pub fn add<S>(&mut self, values: S) -> ValueResult<()>
where S: Into<Self>,

Generic add method

Appends converted input values to the existing list with strict type checking.

Supports any input that can be converted into MultiValues, including single values, vectors, slices, arrays, and borrowed vectors for supported element types.

The converted input must have the same data type as the current container. An empty container keeps its declared type until non-empty values of the same type are appended.

§Type Parameters

S - Input type convertible into MultiValues.

§Errors

Returns ValueError::TypeMismatch when the converted input data type differs from the current container data type.

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

// 1) Single T
let mut mv = MultiValues::Int32(vec![42]);
mv.add(100).unwrap();
assert_eq!(mv.get_int32s().unwrap(), &[42, 100]);

// 2) Vec<T>
mv.add(vec![200, 300]).unwrap();
assert_eq!(mv.get_int32s().unwrap(), &[42, 100, 200, 300]);

// 3) &[T]
let slice = &[400, 500][..];
mv.add(slice).unwrap();
assert_eq!(mv.get_int32s().unwrap(), &[42, 100, 200, 300, 400, 500]);

Source

pub fn data_type(&self) -> DataType

Get the data type of the values

§Returns

Returns the data type corresponding to these multiple values

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let values = MultiValues::Int32(vec![1, 2, 3]);
assert_eq!(values.data_type(), DataType::Int32);

Source

pub fn count(&self) -> usize

Get the number of values

§Returns

Returns the number of values contained in these multiple values

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let values = MultiValues::Int32(vec![1, 2, 3]);
assert_eq!(values.count(), 3);

let empty = MultiValues::Empty(DataType::String);
assert_eq!(empty.count(), 0);

Source

pub fn is_empty(&self) -> bool

Check if empty

§Returns

Returns true if these multiple values do not contain any values

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let values = MultiValues::Int32(vec![]);
assert!(values.is_empty());

let empty = MultiValues::Empty(DataType::String);
assert!(empty.is_empty());

Source

pub fn clear(&mut self)

Clear all values while preserving the type

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let mut values = MultiValues::Int32(vec![1, 2, 3]);
values.clear();
assert!(values.is_empty());
assert_eq!(values.data_type(), DataType::Int32);

Source

pub fn set_type(&mut self, data_type: DataType)

Set the data type

If the new type differs from the current type, clears all values and sets the new type.

§Parameters

data_type - The data type to set

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let mut values = MultiValues::Int32(vec![1, 2, 3]);
values.set_type(DataType::String);
assert!(values.is_empty());
assert_eq!(values.data_type(), DataType::String);

Source §

impl MultiValues

Source

pub fn get_first_bool(&self) -> ValueResult<bool>

Get the first boolean value.

§Returns

If types match and a value exists, returns the first boolean value; see # Errors.

§Example

use qubit_value::MultiValues;

let values = MultiValues::Bool(vec![true, false]);
assert_eq!(values.get_first_bool().unwrap(), true);

If types match, returns a reference to the boolean value array; see # Errors.

§Example

use qubit_value::MultiValues;

let values = MultiValues::Bool(vec![true, false, true]);
assert_eq!(values.get_bools().unwrap(), &[true, false, true]);

Set all boolean values

§Parameters

values - The list of boolean values to set

§Returns

Always returns Ok(()) for this supported setter.

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let mut values = MultiValues::Empty(DataType::Bool);
values.set_bools(vec![true, false, true]).unwrap();
assert_eq!(values.get_bools().unwrap(), &[true, false, true]);

Source

pub fn set_chars(&mut self, values: Vec<char>) -> ValueResult<()>

Set all character values

§Parameters

values - The list of character values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int8s(&mut self, values: Vec<i8>) -> ValueResult<()>

Set all int8 values

§Parameters

values - The list of int8 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int16s(&mut self, values: Vec<i16>) -> ValueResult<()>

Set all int16 values

§Parameters

values - The list of int16 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int32s(&mut self, values: Vec<i32>) -> ValueResult<()>

Set all int32 values

§Parameters

values - The list of int32 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int64s(&mut self, values: Vec<i64>) -> ValueResult<()>

Set all int64 values

§Parameters

values - The list of int64 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int128s(&mut self, values: Vec<i128>) -> ValueResult<()>

Set all int128 values

§Parameters

values - The list of int128 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint8s(&mut self, values: Vec<u8>) -> ValueResult<()>

Set all uint8 values

§Parameters

values - The list of uint8 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint16s(&mut self, values: Vec<u16>) -> ValueResult<()>

Set all uint16 values

§Parameters

values - The list of uint16 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint32s(&mut self, values: Vec<u32>) -> ValueResult<()>

Set all uint32 values

§Parameters

values - The list of uint32 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint64s(&mut self, values: Vec<u64>) -> ValueResult<()>

Set all uint64 values

§Parameters

values - The list of uint64 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint128s(&mut self, values: Vec<u128>) -> ValueResult<()>

Set all uint128 values

§Parameters

values - The list of uint128 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_float32s(&mut self, values: Vec<f32>) -> ValueResult<()>

Set all float32 values

§Parameters

values - The list of float32 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_float64s(&mut self, values: Vec<f64>) -> ValueResult<()>

Set all float64 values

§Parameters

values - The list of float64 values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_strings(&mut self, values: Vec<String>) -> ValueResult<()>

Set all string values

§Parameters

values - The list of string values to set

§Returns

Always returns Ok(()) for this supported setter.

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let mut values = MultiValues::Empty(DataType::String);
values.set_strings(vec!["hello".to_string(), "world".to_string()]).unwrap();
assert_eq!(values.get_strings().unwrap(), &["hello", "world"]);

Source

pub fn set_dates(&mut self, values: Vec<NaiveDate>) -> ValueResult<()>

Set all date values

§Parameters

values - The list of date values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_times(&mut self, values: Vec<NaiveTime>) -> ValueResult<()>

Set all time values

§Parameters

values - The list of time values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_datetimes(&mut self, values: Vec<NaiveDateTime>) -> ValueResult<()>

Set all datetime values

§Parameters

values - The list of datetime values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_instants(&mut self, values: Vec<DateTime<Utc>>) -> ValueResult<()>

Set all UTC instant values

§Parameters

values - The list of UTC instant values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_bigintegers(&mut self, values: Vec<BigInt>) -> ValueResult<()>

Set all big integer values

§Parameters

values - The list of big integer values to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_bigdecimals(&mut self, values: Vec<BigDecimal>) -> ValueResult<()>

Set all big decimal values

§Parameters

values - The list of big decimal values to set

values - The big decimal value slice to set

value - The boolean value to set

§Returns

Always returns Ok(()) for this supported setter.

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let mut values = MultiValues::Empty(DataType::Bool);
values.set_bool(true).unwrap();
assert_eq!(values.get_bools().unwrap(), &[true]);

Source

pub fn set_char(&mut self, value: char) -> ValueResult<()>

Set single character value

§Parameters

value - The character value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int8(&mut self, value: i8) -> ValueResult<()>

Set single int8 value

§Parameters

value - The int8 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int16(&mut self, value: i16) -> ValueResult<()>

Set single int16 value

§Parameters

value - The int16 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int32(&mut self, value: i32) -> ValueResult<()>

Set single int32 value

§Parameters

value - The int32 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int64(&mut self, value: i64) -> ValueResult<()>

Set single int64 value

§Parameters

value - The int64 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_int128(&mut self, value: i128) -> ValueResult<()>

Set single int128 value

§Parameters

value - The int128 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint8(&mut self, value: u8) -> ValueResult<()>

Set single uint8 value

§Parameters

value - The uint8 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint16(&mut self, value: u16) -> ValueResult<()>

Set single uint16 value

§Parameters

value - The uint16 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint32(&mut self, value: u32) -> ValueResult<()>

Set single uint32 value

§Parameters

value - The uint32 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint64(&mut self, value: u64) -> ValueResult<()>

Set single uint64 value

§Parameters

value - The uint64 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_uint128(&mut self, value: u128) -> ValueResult<()>

Set single uint128 value

§Parameters

value - The uint128 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_float32(&mut self, value: f32) -> ValueResult<()>

Set single float32 value

§Parameters

value - The float32 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_float64(&mut self, value: f64) -> ValueResult<()>

Set single float64 value

§Parameters

value - The float64 value to set

§Returns

Always returns Ok(()) for this supported setter.

Source

pub fn set_string(&mut self, value: String) -> ValueResult<()>

Set single string value

§Parameters

value - The string value to set

§Returns

Always returns Ok(()) for this supported setter.

§Example

use qubit_datatype::DataType;
use qubit_value::MultiValues;

let mut values = MultiValues::Empty(DataType::String);
values.set_string("hello".to_string()).unwrap();
assert_eq!(values.get_strings().unwrap(), &["hello"]);

Source