Struct polars_core::datatypes::Field

pub struct Field { /* private fields */ }

Characterizes the name and the DataType of a column.

Implementations

impl Field

pub fn new(name: &str, dtype: DataType) -> Self

Creates a new Field.

Example

let f1 = Field::new("Fruit name", DataType::Utf8);
let f2 = Field::new("Lawful", DataType::Boolean);
let f2 = Field::new("Departure", DataType::Time);

pub fn from_owned(name: String, dtype: DataType) -> Self

pub fn name(&self) -> &String

Returns a reference to the Field name.

Example

let f = Field::new("Year", DataType::Int32);

assert_eq!(f.name(), "Year");

pub fn data_type(&self) -> &DataType

Returns a reference to the Field datatype.

Example

let f = Field::new("Birthday", DataType::Date);

assert_eq!(f.data_type(), &DataType::Date);

pub fn coerce(&mut self, dtype: DataType)

Sets the Field datatype.

Example

let mut f = Field::new("Temperature", DataType::Int32);
f.coerce(DataType::Float32);

assert_eq!(f, Field::new("Temperature", DataType::Float32));

pub fn set_name(&mut self, name: String)

Sets the Field name.

Example

let mut f = Field::new("Atomic number", DataType::UInt32);
f.set_name("Proton".to_owned());

assert_eq!(f, Field::new("Proton", DataType::UInt32));

pub fn to_arrow(&self) -> ArrowField

Converts the Field to an arrow::datatypes::Field.

Example

let f = Field::new("Value", DataType::Int64);
let af = arrow::datatypes::Field::new("Value", arrow::datatypes::DataType::Int64, true);

assert_eq!(f.to_arrow(), af);

Trait Implementations

impl Clone for Field

fn clone(&self) -> Field

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for Field

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

Formats the value using the given formatter.

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

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

Performs the conversion.

impl From<&'_ Field> for Field

fn from(f: &ArrowField) -> Self

Performs the conversion.

impl PartialEq<Field> for Field

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

This method tests for self and other values to be equal, and is used by ==.

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

This method tests for !=.

impl StructuralPartialEq for Field