Trait Parser

pub trait Parser: ArrowPrimitiveType {
    // Required method
    fn parse(string: &str) -> Option<Self::Native>;

    // Provided method
    fn parse_formatted(string: &str, _format: &str) -> Option<Self::Native> { ... }
}

Specialized parsing implementations to convert strings to Arrow types.

This is used by csv and json reader and can be used directly as well.

Example

To parse a string to a Date32Type:

use arrow_cast::parse::Parser;
use arrow_array::types::Date32Type;
let date = Date32Type::parse("2021-01-01").unwrap();
assert_eq!(date, 18628);

To parse a string to a TimestampNanosecondType:

use arrow_cast::parse::Parser;
use arrow_array::types::TimestampNanosecondType;
let ts = TimestampNanosecondType::parse("2021-01-01T00:00:00.123456789Z").unwrap();
assert_eq!(ts, 1609459200123456789);

Required Methods

fn parse(string: &str) -> Option<Self::Native>

Parse a string to the native type

Provided Methods

fn parse_formatted(string: &str, _format: &str) -> Option<Self::Native>

Parse a string to the native type with a format string

When not implemented, the format string is unused, and this method is equivalent to parse

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementations on Foreign Types

impl Parser for Date32Type

fn parse(string: &str) -> Option<i32>

fn parse_formatted(string: &str, format: &str) -> Option<i32>

impl Parser for Date64Type

fn parse(string: &str) -> Option<i64>

fn parse_formatted(string: &str, format: &str) -> Option<i64>

impl Parser for DurationMicrosecondType

fn parse(string: &str) -> Option<Self::Native>

impl Parser for DurationMillisecondType

fn parse(string: &str) -> Option<Self::Native>

impl Parser for DurationNanosecondType

fn parse(string: &str) -> Option<Self::Native>

impl Parser for DurationSecondType

fn parse(string: &str) -> Option<Self::Native>

impl Parser for Float16Type

fn parse(string: &str) -> Option<f16>

impl Parser for Float32Type

fn parse(string: &str) -> Option<f32>

impl Parser for Float64Type

fn parse(string: &str) -> Option<f64>

impl Parser for Int8Type

fn parse(string: &str) -> Option<Self::Native>

impl Parser for Int16Type

fn parse(string: &str) -> Option<Self::Native>

impl Parser for Int32Type

fn parse(string: &str) -> Option<Self::Native>

impl Parser for Int64Type

fn parse(string: &str) -> Option<Self::Native>

impl Parser for Time32MillisecondType

fn parse(string: &str) -> Option<Self::Native>

fn parse_formatted(string: &str, format: &str) -> Option<Self::Native>

impl Parser for Time32SecondType

fn parse(string: &str) -> Option<Self::Native>

fn parse_formatted(string: &str, format: &str) -> Option<Self::Native>

impl Parser for Time64MicrosecondType

fn parse(string: &str) -> Option<Self::Native>

fn parse_formatted(string: &str, format: &str) -> Option<Self::Native>

impl Parser for Time64NanosecondType

fn parse(string: &str) -> Option<Self::Native>

fn parse_formatted(string: &str, format: &str) -> Option<Self::Native>

impl Parser for TimestampMicrosecondType

fn parse(string: &str) -> Option<i64>

impl Parser for TimestampMillisecondType

fn parse(string: &str) -> Option<i64>

impl Parser for TimestampNanosecondType

fn parse(string: &str) -> Option<i64>

impl Parser for TimestampSecondType

fn parse(string: &str) -> Option<i64>

impl Parser for UInt8Type

fn parse(string: &str) -> Option<Self::Native>

impl Parser for UInt16Type

fn parse(string: &str) -> Option<Self::Native>

impl Parser for UInt32Type

fn parse(string: &str) -> Option<Self::Native>

impl Parser for UInt64Type

fn parse(string: &str) -> Option<Self::Native>

Implementors