Enum polars_core::datatypes::AnyValue

pub enum AnyValue<'a> {
    Null,
    Boolean(bool),
    Utf8(&'a str),
    UInt8(u8),
    UInt16(u16),
    UInt32(u32),
    UInt64(u64),
    Int8(i8),
    Int16(i16),
    Int32(i32),
    Int64(i64),
    Float32(f32),
    Float64(f64),
    Date(i32),
    Datetime(i64, TimeUnit, &'a Option<TimeZone>),
    Duration(i64, TimeUnit),
    Time(i64),
    Categorical(u32, &'a RevMapping, SyncPtr<Utf8Array<i64>>),
    List(Series),
    Object(&'a dyn PolarsObjectSafe),
    ObjectOwned(OwnedObject),
    Struct(usize, &'a StructArray, &'a [Field]),
    StructOwned(Box<(Vec<AnyValue<'a>>, Vec<Field>)>),
    Utf8Owned(String),
    Binary(&'a [u8]),
    BinaryOwned(Vec<u8>),
}

Variants

Null

Boolean(bool)

A binary true or false.

Utf8(&'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.

Date(i32)

Available on crate feature dtype-date only.

A 32-bit date representing the elapsed time since UNIX epoch (1970-01-01) in days (32 bits).

Datetime(i64, TimeUnit, &'a Option<TimeZone>)

Available on crate feature dtype-datetime only.

A 64-bit date representing the elapsed time since UNIX epoch (1970-01-01) in nanoseconds (64 bits).

Duration(i64, TimeUnit)

Available on crate feature dtype-duration only.

Time(i64)

Available on crate feature dtype-time only.

A 64-bit time representing the elapsed time since midnight in nanoseconds

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

Available on crate feature dtype-categorical only.

List(Series)

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

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.

Struct(usize, &'a StructArray, &'a [Field])

Available on crate feature dtype-struct only.

StructOwned(Box<(Vec<AnyValue<'a>>, Vec<Field>)>)

Available on crate feature dtype-struct only.

Utf8Owned(String)

An UTF8 encoded string type.

Binary(&'a [u8])

Available on crate feature dtype-binary only.

BinaryOwned(Vec<u8>)

Available on crate feature dtype-binary only.

Implementations

impl<'a> AnyValue<'a>

pub fn _iter_struct_av(&self) -> impl Iterator<Item = AnyValue<'_>>

Available on crate feature dtype-struct only.

pub fn _materialize_struct_av(&'a self, buf: &mut Vec<AnyValue<'a>>)

Available on crate feature dtype-struct only.

impl<'a> AnyValue<'a>

pub fn dtype(&self) -> DataType

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

impl<'a> AnyValue<'a>

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

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.

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 Default for AnyValue<'static>

fn default() -> Self

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 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(val: &AnyValue<'a>) -> Self

Converts to this type from the input type.

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

Available on crate feature rows only.

fn from(val: &AnyValue<'a>) -> 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<'_>

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<'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<AnyValue<'_>> 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<AnyValue<'_>> 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<'a> Eq for AnyValue<'a>