Module cast 

Cast kernels to convert [ArrayRef] between supported datatypes.

See cast_with_options for more information on specific conversions.

Example:

// int32 to float64
let a = Int32Array::from(vec![5, 6, 7]);
let b = cast(&a, &DataType::Float64).unwrap();
let c = b.as_primitive::<Float64Type>();
assert_eq!(5.0, c.value(0));
assert_eq!(6.0, c.value(1));
assert_eq!(7.0, c.value(2));

Re-exports

pub(crate) use crate::cast::numeric::cast_bool_to_numeric; 🔒

pub(crate) use crate::cast::numeric::cast_numeric_arrays; 🔒

pub(crate) use crate::cast::numeric::cast_numeric_to_bool; 🔒

pub use crate::cast::numeric::cast_num_to_bool;

pub use crate::cast::numeric::num_cast;

pub use crate::cast::numeric::single_bool_to_numeric;

use chrono::TimeZone; 🔒

use chrono::Utc; 🔒

use std::cmp::Ordering; 🔒

use std::sync::Arc; 🔒

use crate::display::ArrayFormatter; 🔒

use crate::display::FormatOptions; 🔒

use crate::parse::Parser; 🔒

use crate::parse::parse_interval_day_time; 🔒

use crate::parse::parse_interval_month_day_nano; 🔒

use crate::parse::parse_interval_year_month; 🔒

use crate::parse::string_to_datetime; 🔒

use arrow_array::timezone::Tz; 🔒

use arrow_buffer::ArrowNativeType; 🔒

use arrow_buffer::OffsetBuffer; 🔒

use arrow_buffer::i256; 🔒

use arrow_data::ArrayData; 🔒

use arrow_data::transform::MutableArrayData; 🔒

use arrow_select::take::take; 🔒

use num_traits::NumCast; 🔒

use num_traits::ToPrimitive; 🔒

use num_traits::cast::AsPrimitive; 🔒

pub use decimal::DecimalCast;

pub use decimal::float_to_decimal;

pub use decimal::float_to_decimal_opt;

pub use decimal::rescale_decimal;

pub use decimal::parse_string_to_decimal_native;Deprecated

pub use decimal::single_float_to_decimal;Deprecated

pub use string::cast_single_string_to_boolean_default;

use crate::cast::binary::*; 🔒

use crate::cast::decimal::*; 🔒

use crate::cast::dictionary::*; 🔒

use crate::cast::list::*; 🔒

use crate::cast::map::*; 🔒

use crate::cast::run_array::*; 🔒

use crate::cast::string::*; 🔒

use crate::cast::structs::*; 🔒

use crate::cast::temporal::*; 🔒

use arrow_array::builder::*; 🔒

use arrow_array::cast::*; 🔒

use arrow_array::temporal_conversions::*; 🔒

use arrow_array::types::*; 🔒

use arrow_array::*; 🔒

use arrow_schema::*; 🔒

Modules

binary 🔒

Cast support for binary, fixed-size binary and byte-view arrays.

decimal 🔒

dictionary 🔒

list 🔒

map 🔒

numeric 🔒

Cast support for numeric and boolean arrays.

run_array 🔒

string 🔒

structs 🔒

temporal 🔒

Cast support for temporal arrays: timestamps, dates, durations, intervals, and timezones.

union 🔒

Cast support for union arrays.

Structs

CastOptions

CastOptions provides a way to override the default cast behaviors

Constants

F32_EXACT_INT_LIMIT 🔒

Integers below 2^24 convert to an f32 exactly.

F64_EXACT_INT_LIMIT 🔒

Integers below 2^53 convert to an f64 exactly.

Functions

can_cast_types

Return true if a value of type from_type can be cast into a value of to_type.

cast

Cast array to the provided data type and return a new Array with type to_type, if possible.

cast_decimal_to_f32 🔒

Casts a decimal array to Float32, rounding each value once. Same shape as cast_decimal_to_f64, with the smaller bounds an f32 allows: integers are exact below 2^24, and 10^k only up to k = 10.

cast_decimal_to_f64 🔒

Casts a decimal array to Float64, rounding each value once.

cast_reinterpret_arrays 🔒

Cast the primitive array using [PrimitiveArray::reinterpret_cast]

cast_time64_to_time32 🔒

cast_with_options

Try to cast array to to_type if possible.

decimal_to_f32_rounded_once 🔒

As decimal_to_f64_rounded_once, but narrowing to f32 in one step. Rounding to f64 first and then to f32 rounds twice: a decimal just above an f32 midpoint can collapse onto that midpoint in f64, and round-half-even then sends it the wrong way.

decimal_to_f64_rounded_once 🔒

Rounds once for the values the arithmetic cannot convert exactly, by parsing the decimal’s own text.

resolve_child_array

Selects the best-matching child array from a [UnionArray] for a given target type

same_type_family

single_decimal_to_float_lossy

Lossy conversion from decimal to float.

time_unit_multiple 🔒

Get the time unit as a multiple of a second

union_extract_by_type

Extracts the best-matching child array from a [UnionArray] for a given target type, and casts it to that type.

units_per_day 🔒

Number of T units in one day