Struct Column 

pub struct Column { /* private fields */ }

A single named column with homogeneous type.

Implementations

impl Column

pub fn new_bool(name: impl Into<String>, data: Vec<Option<bool>>) -> Self

Create a boolean column with nullable values.

pub fn new_i64(name: impl Into<String>, data: Vec<Option<i64>>) -> Self

Create an i64 column with nullable values.

pub fn new_u64(name: impl Into<String>, data: Vec<Option<u64>>) -> Self

Create a u64 column with nullable values.

pub fn new_f64(name: impl Into<String>, data: Vec<Option<f64>>) -> Self

Create an f64 column with nullable values.

pub fn new_string(name: impl Into<String>, data: Vec<Option<String>>) -> Self

Create a string column with nullable values.

pub fn from_bools(name: impl Into<String>, data: Vec<bool>) -> Self

Create a boolean column from non-nullable values.

pub fn from_i64s(name: impl Into<String>, data: Vec<i64>) -> Self

Create an i64 column from non-nullable values.

pub fn from_u64s(name: impl Into<String>, data: Vec<u64>) -> Self

Create a u64 column from non-nullable values.

pub fn from_f64s(name: impl Into<String>, data: Vec<f64>) -> Self

Create an f64 column from non-nullable values.

pub fn from_strings(name: impl Into<String>, data: Vec<String>) -> Self

Create a string column from owned strings (non-nullable).

pub fn from_strs(name: impl Into<String>, data: &[&str]) -> Self

Create a string column from string slices (non-nullable).

pub fn name(&self) -> &str

Column name.

pub fn dtype(&self) -> DataType

Data type of this column.

pub fn len(&self) -> usize

Number of elements (including nulls).

pub fn is_empty(&self) -> bool

Whether the column is empty.

pub fn non_null_count(&self) -> usize

Count of non-null values.

pub fn null_count(&self) -> usize

Count of null values.

pub fn data(&self) -> &ColumnData

Get the underlying data reference.

pub fn get(&self, index: usize) -> Option<Scalar>

Get value at index as Scalar. Returns None if index out of bounds.

pub fn rename(&self, name: impl Into<String>) -> Self

Rename this column (returns a new column).

pub fn take(&self, indices: &[usize]) -> Self

Take rows at specified indices.

pub fn take_optional(&self, indices: &[Option<usize>]) -> Self

Take rows at optional indices. None produces null values. Used by join operations where one side may have no matching row.

pub fn as_str_iter( &self, ) -> Result<impl Iterator<Item = Option<&str>>, DataFrameError>

Iterate as string references. Returns Err if column is not Utf8.

pub fn as_i64_iter( &self, ) -> Result<impl Iterator<Item = Option<i64>> + '_, DataFrameError>

Iterate as i64 values. Returns Err if column is not Int64.

pub fn as_u64_iter( &self, ) -> Result<impl Iterator<Item = Option<u64>> + '_, DataFrameError>

Iterate as u64 values. Returns Err if column is not UInt64.

pub fn as_f64_iter( &self, ) -> Result<impl Iterator<Item = Option<f64>> + '_, DataFrameError>

Iterate as f64 values. Returns Err if column is not Float64.

pub fn as_bool_iter( &self, ) -> Result<impl Iterator<Item = Option<bool>> + '_, DataFrameError>

Iterate as bool values. Returns Err if column is not Bool.

pub fn get_str(&self, index: usize) -> Result<Option<&str>, DataFrameError>

Get a string value at index. Returns Err if not Utf8 column.

impl Column

pub fn sum(&self) -> Scalar

Sum of non-null numeric values. Returns Null for empty/non-numeric columns.

pub fn mean(&self) -> Scalar

Mean of non-null numeric values. Returns Null if no non-null values.

pub fn min(&self) -> Scalar

Minimum non-null value. Returns Null if no non-null values.

pub fn max(&self) -> Scalar

Maximum non-null value. Returns Null if no non-null values.

pub fn median(&self) -> Scalar

Median of non-null numeric values. Returns Null if no non-null values.

pub fn std_dev(&self) -> Scalar

Standard deviation (population) of non-null numeric values.

pub fn n_unique(&self) -> usize

Count of unique non-null values.

pub fn first(&self) -> Scalar

First non-null value in the column.

pub fn last(&self) -> Scalar

Last non-null value in the column.

pub fn quantile(&self, q: f64) -> Result<Scalar, DataFrameError>

Get a quantile (0.0 to 1.0) from non-null numeric values.

Trait Implementations

impl Clone for Column

fn clone(&self) -> Column

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Column

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

Formats the value using the given formatter.