Struct polars_lazy::dsl::ListNameSpace

pub struct ListNameSpace(pub Expr);
Expand description

Specialized expressions for Series of DataType::List.

Tuple Fields§

§0: Expr

Implementations§

§

impl ListNameSpace

pub fn any(self) -> Expr

Available on crate feature list_any_all only.

pub fn all(self) -> Expr

Available on crate feature list_any_all only.

pub fn drop_nulls(self) -> Expr

Available on crate feature list_drop_nulls only.

pub fn sample_n( self, n: Expr, with_replacement: bool, shuffle: bool, seed: Option<u64>, ) -> Expr

Available on crate feature list_sample only.

pub fn sample_fraction( self, fraction: Expr, with_replacement: bool, shuffle: bool, seed: Option<u64>, ) -> Expr

Available on crate feature list_sample only.

pub fn len(self) -> Expr

Return the number of elements in each list.

Null values are treated like regular elements in this context.

pub fn max(self) -> Expr

Compute the maximum of the items in every sublist.

pub fn min(self) -> Expr

Compute the minimum of the items in every sublist.

pub fn sum(self) -> Expr

Compute the sum the items in every sublist.

pub fn mean(self) -> Expr

Compute the mean of every sublist and return a Series of dtype Float64

pub fn median(self) -> Expr

pub fn std(self, ddof: u8) -> Expr

pub fn var(self, ddof: u8) -> Expr

pub fn sort(self, options: SortOptions) -> Expr

Sort every sublist.

pub fn reverse(self) -> Expr

Reverse every sublist

pub fn unique(self) -> Expr

Keep only the unique values in every sublist.

pub fn unique_stable(self) -> Expr

Keep only the unique values in every sublist.

pub fn n_unique(self) -> Expr

pub fn get(self, index: Expr, null_on_oob: bool) -> Expr

Get items in every sublist by index.

pub fn gather(self, index: Expr, null_on_oob: bool) -> Expr

Available on crate feature list_gather only.

Get items in every sublist by multiple indexes.

§Arguments
  • null_on_oob: Return a null when an index is out of bounds. This behavior is more expensive than defaulting to returning an Error.

pub fn gather_every(self, n: Expr, offset: Expr) -> Expr

Available on crate feature list_gather only.

pub fn first(self) -> Expr

Get first item of every sublist.

pub fn last(self) -> Expr

Get last item of every sublist.

pub fn join(self, separator: Expr, ignore_nulls: bool) -> Expr

Join all string items in a sublist and place a separator between them.

§Error

This errors if inner type of list != DataType::String.

pub fn arg_min(self) -> Expr

Return the index of the minimal value of every sublist

pub fn arg_max(self) -> Expr

Return the index of the maximum value of every sublist

pub fn diff(self, n: i64, null_behavior: NullBehavior) -> Expr

Available on crate feature diff only.

Diff every sublist.

pub fn shift(self, periods: Expr) -> Expr

Shift every sublist.

pub fn slice(self, offset: Expr, length: Expr) -> Expr

Slice every sublist.

pub fn head(self, n: Expr) -> Expr

Get the head of every sublist

pub fn tail(self, n: Expr) -> Expr

Get the tail of every sublist

pub fn to_array(self, width: usize) -> Expr

Available on crate feature dtype-array only.

Convert a List column into an Array column with the same inner data type.

pub fn to_struct( self, n_fields: ListToStructWidthStrategy, name_generator: Option<Arc<dyn Fn(usize) -> SmartString<LazyCompact> + Sync + Send>>, upper_bound: usize, ) -> Expr

Available on crate feature list_to_struct only.

Convert this List to a Series of type Struct. The width will be determined according to ListToStructWidthStrategy and the names of the fields determined by the given name_generator.

§Schema

A polars LazyFrame needs to know the schema at all time. The caller therefore must provide an upper_bound of struct fields that will be set. If this is incorrectly downstream operation may fail. For instance an all().sum() expression will look in the current schema to determine which columns to select.

pub fn contains<E>(self, other: E) -> Expr
where E: Into<Expr>,

Available on crate feature is_in only.

Check if the list array contain an element

pub fn count_matches<E>(self, element: E) -> Expr
where E: Into<Expr>,

Available on crate feature list_count only.

Count how often the value produced by element occurs.

pub fn union<E>(self, other: E) -> Expr
where E: Into<Expr>,

Available on crate feature list_sets only.

Return the SET UNION between both list arrays.

pub fn set_difference<E>(self, other: E) -> Expr
where E: Into<Expr>,

Available on crate feature list_sets only.

Return the SET DIFFERENCE between both list arrays.

pub fn set_intersection<E>(self, other: E) -> Expr
where E: Into<Expr>,

Available on crate feature list_sets only.

Return the SET INTERSECTION between both list arrays.

pub fn set_symmetric_difference<E>(self, other: E) -> Expr
where E: Into<Expr>,

Available on crate feature list_sets only.

Return the SET SYMMETRIC DIFFERENCE between both list arrays.

Trait Implementations§

source§

impl IntoListNameSpace for ListNameSpace

Available on crate feature list_eval only.
source§

impl ListNameSpaceExtension for ListNameSpace

Available on crate feature list_eval only.
source§

fn eval(self, expr: Expr, parallel: bool) -> Expr

Run any Expr on these lists elements

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> 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
source§

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

§

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>,

§

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

§

impl<T> Ungil for T
where T: Send,