Enum AnyValue 

pub enum AnyValue<'a> {
    Null,
    Boolean(bool),
    String(&'a str),
    UInt8(u8),
    UInt16(u16),
    UInt32(u32),
    UInt64(u64),
    UInt128(u128),
    Int8(i8),
    Int16(i16),
    Int32(i32),
    Int64(i64),
    Int128(i128),
    Float16(pf16),
    Float32(f32),
    Float64(f64),
    Categorical(CatSize, &'a Arc<CategoricalMapping>),
    CategoricalOwned(CatSize, Arc<CategoricalMapping>),
    Enum(CatSize, &'a Arc<CategoricalMapping>),
    EnumOwned(CatSize, Arc<CategoricalMapping>),
    List(Series),
    Array(Series, usize),
    Object(&'a dyn PolarsObjectSafe),
    ObjectOwned(OwnedObject),
    StringOwned(PlSmallStr),
    Binary(&'a [u8]),
    BinaryOwned(Vec<u8>),
    Decimal(i128, usize, 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.

UInt128(u128)

An unsigned 128-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.

Int128(i128)

A 128-bit integer number.

Float16(pf16)

A 16-bit floating point number.

Float32(f32)

A 32-bit floating point number.

Float64(f64)

A 64-bit floating point number.

Categorical(CatSize, &'a Arc<CategoricalMapping>)

Available on crate feature dtype-categorical only.

CategoricalOwned(CatSize, Arc<CategoricalMapping>)

Available on crate feature dtype-categorical only.

Enum(CatSize, &'a Arc<CategoricalMapping>)

Available on crate feature dtype-categorical only.

EnumOwned(CatSize, Arc<CategoricalMapping>)

Available on crate feature dtype-categorical only.

List(Series)

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

Array(Series, usize)

Available on crate feature dtype-array only.

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(PlSmallStr)

An UTF8 encoded string type.

Binary(&'a [u8])

BinaryOwned(Vec<u8>)

Decimal(i128, usize, usize)

Available on crate feature dtype-decimal only.

A 128-bit fixed point decimal number with a precision and scale.

Implementations

impl AnyValue<'static>

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

pub fn can_have_dtype(&self, dtype: &DataType) -> bool

Can the AnyValue exist as having dtype as its DataType.

pub fn default_value( dtype: &DataType, numeric_to_one: bool, num_list_values: usize, ) -> AnyValue<'static>

Generate a default dummy value for a given datatype.

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 + IsFloat>(&self) -> PolarsResult<T>

pub fn is_boolean(&self) -> bool

pub fn is_primitive_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_nan(&self) -> bool

pub fn is_null(&self) -> bool

pub fn is_nested_null(&self) -> bool

pub fn null_to_none(self) -> Option<Self>

Converts AnyValue::Null to None, anything else to Some(self).

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>

pub fn idx(&self) -> IdxSize

pub fn str_value(&self) -> Cow<'a, str>

pub fn to_physical(self) -> Self

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

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

pub fn extract_bytes(&self) -> Option<&[u8]>

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) -> 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 duplicate 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 Hash for AnyValue<'_>

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

Tests for self and other values to be equal, and is used by ==.

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

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

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

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

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

impl Eq for AnyValue<'_>