Enum polars_core::datatypes::AnyValue

pub enum AnyValue<'a> {
    Null,
    Boolean(bool),
    String(&'a str),
    UInt8(u8),
    UInt16(u16),
    UInt32(u32),
    UInt64(u64),
    Int8(i8),
    Int16(i16),
    Int32(i32),
    Int64(i64),
    Float32(f32),
    Float64(f64),
    Categorical(u32, &'a RevMapping, SyncPtr<Utf8ViewArray>),
    Enum(u32, &'a RevMapping, SyncPtr<Utf8ViewArray>),
    List(Series),
    Object(&'a dyn PolarsObjectSafe),
    ObjectOwned(OwnedObject),
    StringOwned(String),
    Binary(&'a [u8]),
    BinaryOwned(Vec<u8>),
    Decimal(i128, usize),
}

Variants

Null

Boolean(bool)

A binary true or false.

String(&'a str)

A UTF8 encoded string type.

UInt8(u8)

An unsigned 8-bit integer number.

UInt16(u16)

An unsigned 16-bit integer number.

UInt32(u32)

An unsigned 32-bit integer number.

UInt64(u64)

An unsigned 64-bit integer number.

Int8(i8)

An 8-bit integer number.

Int16(i16)

A 16-bit integer number.

Int32(i32)

A 32-bit integer number.

Int64(i64)

A 64-bit integer number.

Float32(f32)

A 32-bit floating point number.

Float64(f64)

A 64-bit floating point number.

Categorical(u32, &'a RevMapping, SyncPtr<Utf8ViewArray>)

Available on crate feature dtype-categorical only.

Enum(u32, &'a RevMapping, SyncPtr<Utf8ViewArray>)

Available on crate feature dtype-categorical only.

List(Series)

Nested type, contains arrays that are filled with one of the datatypes.

Object(&'a dyn PolarsObjectSafe)

Available on crate feature object only.

Can be used to fmt and implements Any, so can be downcasted to the proper value type.

ObjectOwned(OwnedObject)

Available on crate feature object only.

StringOwned(String)

An UTF8 encoded string type.

Binary(&'a [u8])

BinaryOwned(Vec<u8>)

Decimal(i128, usize)

Available on crate feature dtype-decimal only.

A 128-bit fixed point decimal number.

Implementations

impl AnyValue<'static>

pub fn zero(dtype: &DataType) -> Self

impl<'a> AnyValue<'a>

pub fn dtype(&self) -> DataType

Get the matching DataType for this AnyValue`.

Note: For Categorical and Enum values, the exact mapping information is not preserved in the result for performance reasons.

pub fn try_extract<T: NumCast>(&self) -> PolarsResult<T>

pub fn is_boolean(&self) -> bool

pub fn is_numeric(&self) -> bool

pub fn is_float(&self) -> bool

pub fn is_integer(&self) -> bool

pub fn is_signed_integer(&self) -> bool

pub fn is_unsigned_integer(&self) -> bool

pub fn is_null(&self) -> bool

pub fn is_nested_null(&self) -> bool

pub fn strict_cast(&self, dtype: &'a DataType) -> Option<AnyValue<'a>>

Cast AnyValue to the provided data type and return a new AnyValue with type dtype, if possible.

pub fn try_strict_cast(&self, dtype: &'a DataType) -> PolarsResult<AnyValue<'a>>

Cast AnyValue to the provided data type and return a new AnyValue with type dtype, if possible.

pub fn cast(&self, dtype: &'a DataType) -> AnyValue<'a>

impl AnyValue<'_>

pub fn hash_impl<H: Hasher>(&self, state: &mut H, cheap: bool)

impl<'a> AnyValue<'a>

pub fn add(&self, rhs: &AnyValue<'_>) -> AnyValue<'static>

pub fn as_borrowed(&self) -> AnyValue<'_>

pub fn into_static(self) -> PolarsResult<AnyValue<'static>>

Try to coerce to an AnyValue with static lifetime. This can be done if it does not borrow any values.

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

Get a reference to the &str contained within AnyValue.

impl AnyValue<'_>

pub fn eq_missing(&self, other: &Self, null_equal: bool) -> bool

Trait Implementations

impl<'a> Clone for AnyValue<'a>

fn clone(&self) -> AnyValue<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for AnyValue<'a>

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

Formats the value using the given formatter.

impl<'a> Default for AnyValue<'a>

fn default() -> AnyValue<'a>

Returns the “default value” for a type.

impl Display for AnyValue<'_>

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

Formats the value using the given formatter.

impl<'a> From<&'a [u8]> for AnyValue<'a>

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

Converts to this type from the input type.

impl From<&AnyValue<'_>> for NaiveDateTime

Available on crate features temporal or dtype-datetime or dtype-date only.

fn from(v: &AnyValue<'_>) -> Self

Converts to this type from the input type.

impl From<&AnyValue<'_>> for NaiveTime

Available on crate features temporal or dtype-datetime or dtype-date only.

fn from(v: &AnyValue<'_>) -> Self

Converts to this type from the input type.

impl<'a> From<&AnyValue<'a>> for DataType

fn from(value: &AnyValue<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<&AnyValue<'a>> for Field

Available on crate features rows or object only.

fn from(val: &AnyValue<'a>) -> Self

Converts to this type from the input type.

impl<'a> From<&'a str> for AnyValue<'a>

fn from(value: &'a str) -> Self

Converts to this type from the input type.

impl From<AnyValue<'_>> for DataType

fn from(value: AnyValue<'_>) -> Self

Converts to this type from the input type.

impl<'a> From<AnyValue<'a>> for Option<i64>

fn from(val: AnyValue<'a>) -> Self

Converts to this type from the input type.

impl<K: NumericNative> From<K> for AnyValue<'static>

fn from(value: K) -> Self

Converts to this type from the input type.

impl<'a, T> From<Option<T>> for AnyValue<'a>

where T: Into<AnyValue<'a>>,

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

Converts to this type from the input type.

impl From<bool> for AnyValue<'static>

fn from(value: bool) -> Self

Converts to this type from the input type.

impl<'a> Hash for AnyValue<'a>

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 AnyValue<'_>

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl PartialOrd for AnyValue<'_>

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

Only implemented for the same types and physical types!

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

This method tests less than (for self and other) and is used by the < operator.

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

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

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

This method tests greater than (for self and other) and is used by the > operator.

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

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

impl TotalEq for AnyValue<'_>

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

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

impl<'a> Eq for AnyValue<'a>