polars_core::datatypes

Enum DataType

Source
pub enum DataType {
Show 26 variants Boolean, UInt8, UInt16, UInt32, UInt64, Int8, Int16, Int32, Int64, Float32, Float64, Decimal(Option<usize>, Option<usize>), String, Binary, BinaryOffset, Date, Datetime(TimeUnit, Option<TimeZone>), Duration(TimeUnit), Time, Array(Box<DataType>, usize), List(Box<DataType>), Object(&'static str, Option<Arc<ObjectRegistry>>), Null, Categorical(Option<Arc<RevMapping>>, CategoricalOrdering), Enum(Option<Arc<RevMapping>>, CategoricalOrdering), Unknown(UnknownKind),
}

Variants§

§

Boolean

§

UInt8

§

UInt16

§

UInt32

§

UInt64

§

Int8

§

Int16

§

Int32

§

Int64

§

Float32

§

Float64

§

Decimal(Option<usize>, Option<usize>)

Available on crate feature dtype-decimal only.

Fixed point decimal type optional precision and non-negative scale. This is backed by a signed 128-bit integer which allows for up to 38 significant digits. Meaning max precision is 38.

§

String

String data

§

Binary

§

BinaryOffset

§

Date

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

§

Datetime(TimeUnit, Option<TimeZone>)

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

§

Duration(TimeUnit)

§

Time

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

§

Array(Box<DataType>, usize)

Available on crate feature dtype-array only.

A nested list with a fixed size in each row

§

List(Box<DataType>)

A nested list with a variable size in each row

§

Object(&'static str, Option<Arc<ObjectRegistry>>)

Available on crate feature object only.

A generic type that can be used in a Series &’static str can be used to determine/set inner type

§

Null

§

Categorical(Option<Arc<RevMapping>>, CategoricalOrdering)

Available on crate feature dtype-categorical only.
§

Enum(Option<Arc<RevMapping>>, CategoricalOrdering)

Available on crate feature dtype-categorical only.
§

Unknown(UnknownKind)

Implementations§

Source§

impl DataType

Source

pub fn value_within_range(&self, other: AnyValue<'_>) -> bool

Source

pub fn is_known(&self) -> bool

Check if the whole dtype is known.

Source

pub fn materialize_unknown(&self) -> PolarsResult<DataType>

Materialize this datatype if it is unknown. All other datatypes are left unchanged.

Source

pub fn get_shape(&self) -> Option<Vec<usize>>

Available on crate feature dtype-array only.

Get the full shape of a multidimensional array.

Source

pub fn inner_dtype(&self) -> Option<&DataType>

Get the inner data type of a nested type.

Source

pub fn leaf_dtype(&self) -> &DataType

Get the absolute inner data type of a nested type.

Source

pub fn array_leaf_dtype(&self) -> Option<&DataType>

Available on crate feature dtype-array only.

Get the inner data type of a multidimensional array.

Source

pub fn cast_leaf(&self, to: DataType) -> DataType

Cast the leaf types of Lists/Arrays and keep the nesting.

Source

pub fn implode(self) -> DataType

Source

pub fn to_physical(&self) -> DataType

Convert to the physical data type

Source

pub fn is_supported_list_arithmetic_input(&self) -> bool

Source

pub fn is_logical(&self) -> bool

Check if this DataType is a logical type

Source

pub fn is_temporal(&self) -> bool

Check if this DataType is a temporal type

Source

pub fn is_primitive(&self) -> bool

Check if datatype is a primitive type. By that we mean that it is not a container type.

Source

pub fn is_numeric(&self) -> bool

Check if this DataType is a basic numeric type (excludes Decimal).

Source

pub fn is_bool(&self) -> bool

Check if this DataType is a boolean.

Source

pub fn is_list(&self) -> bool

Check if this DataType is a list.

Source

pub fn is_array(&self) -> bool

Check if this DataType is an array.

Source

pub fn is_nested(&self) -> bool

Source

pub fn is_struct(&self) -> bool

Check if this DataType is a struct

Source

pub fn is_binary(&self) -> bool

Source

pub fn is_date(&self) -> bool

Source

pub fn is_object(&self) -> bool

Source

pub fn is_null(&self) -> bool

Source

pub fn contains_views(&self) -> bool

Source

pub fn contains_categoricals(&self) -> bool

Source

pub fn contains_objects(&self) -> bool

Source

pub fn is_ord(&self) -> bool

Check if type is sortable

Source

pub fn is_decimal(&self) -> bool

Check if this DataType is a Decimal type (of any scale/precision).

Source

pub fn is_float(&self) -> bool

Check if this DataType is a basic floating point type (excludes Decimal).

Source

pub fn is_integer(&self) -> bool

Check if this DataType is an integer.

Source

pub fn is_signed_integer(&self) -> bool

Source

pub fn is_unsigned_integer(&self) -> bool

Source

pub fn is_string(&self) -> bool

Source

pub fn is_categorical(&self) -> bool

Source

pub fn is_enum(&self) -> bool

Source

pub fn to_arrow_field( &self, name: PlSmallStr, compat_level: CompatLevel, ) -> ArrowField

Convert to an Arrow Field

Source

pub fn max(&self) -> PolarsResult<Scalar>

Try to get the maximum value for this datatype.

Source

pub fn min(&self) -> PolarsResult<Scalar>

Try to get the minimum value for this datatype.

Source

pub fn to_arrow(&self, compat_level: CompatLevel) -> ArrowDataType

Convert to an Arrow data type.

Source

pub fn try_to_arrow( &self, compat_level: CompatLevel, ) -> PolarsResult<ArrowDataType>

Source

pub fn is_nested_null(&self) -> bool

Source

pub fn matches_schema_type(&self, schema_type: &DataType) -> PolarsResult<bool>

Source§

impl DataType

Source

pub fn boxed(self) -> Box<DataType>

Source

pub fn from_arrow_field(field: &ArrowField) -> DataType

Source

pub fn from_arrow_dtype(dt: &ArrowDataType) -> DataType

Source

pub fn from_arrow( dt: &ArrowDataType, bin_to_view: bool, md: Option<&Metadata>, ) -> DataType

Trait Implementations§

Source§

impl AsRef<DataType> for DataType

Source§

fn as_ref(&self) -> &DataType

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl AsRef<DataType> for Field

Source§

fn as_ref(&self) -> &DataType

Converts this type into a shared reference of the (usually inferred) input type.
Source§

impl Clone for DataType

Source§

fn clone(&self) -> DataType

Returns a copy of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl Debug for DataType

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Default for DataType

Source§

fn default() -> Self

Returns the “default value” for a type. Read more
Source§

impl Display for DataType

Source§

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

Formats the value using the given formatter. Read more
Source§

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

Source§

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

Converts to this type from the input type.
Source§

impl From<AnyValue<'_>> for DataType

Source§

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

Converts to this type from the input type.
Source§

impl Hash for DataType

Source§

fn hash<H: Hasher>(&self, state: &mut H)

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

fn hash_slice<H>(data: &[Self], state: &mut H)
where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher. Read more
Source§

impl PartialEq for DataType

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.
Source§

impl Eq for DataType

Auto Trait Implementations§

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dst: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dst. Read more
Source§

impl<T> DynClone for T
where T: Clone,

Source§

fn __clone_box(&self, _: Private) -> *mut ()

§

impl<Q, K> Equivalent<K> for Q
where Q: Eq + ?Sized, K: Borrow<Q> + ?Sized,

§

fn equivalent(&self, key: &K) -> bool

Compare self to key and return true if they are equal.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> IntoEither for T

Source§

fn into_either(self, into_left: bool) -> Either<Self, Self>

Converts self into a Left variant of Either<Self, Self> if into_left is true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
Source§

fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
where F: FnOnce(&Self) -> bool,

Converts self into a Left variant of Either<Self, Self> if into_left(&self) returns true. Converts self into a Right variant of Either<Self, Self> otherwise. Read more
§

impl<T> Pointable for T

§

const ALIGN: usize = _

The alignment of pointer.
§

type Init = T

The type for initializers.
§

unsafe fn init(init: <T as Pointable>::Init) -> usize

Initializes a with the given initializer. Read more
§

unsafe fn deref<'a>(ptr: usize) -> &'a T

Dereferences the given pointer. Read more
§

unsafe fn deref_mut<'a>(ptr: usize) -> &'a mut T

Mutably dereferences the given pointer. Read more
§

unsafe fn drop(ptr: usize)

Drops the object pointed to by the given pointer. Read more
§

impl<T> ToCompactString for T
where T: Display,

§

fn try_to_compact_string(&self) -> Result<CompactString, ToCompactStringError>

Fallible version of [ToCompactString::to_compact_string()] Read more
§

fn to_compact_string(&self) -> CompactString

Converts the given value to a [CompactString]. Read more
Source§

impl<T> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
Source§

impl<T> ToString for T
where T: Display + ?Sized,

Source§

default fn to_string(&self) -> String

Converts the given value to a String. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
§

impl<V, T> VZip<V> for T
where V: MultiLane<T>,

§

fn vzip(self) -> V