Enum repr::gen::row::proto_datum::DatumType

pub enum DatumType {
    Other(i32),
    Int16(i32),
    Int32(i32),
    Int64(i64),
    Float32(f32),
    Float64(f64),
    Bytes(Vec<u8>),
    String(String),
    Date(ProtoDate),
    Time(ProtoTime),
    Timestamp(ProtoTimestamp),
    Interval(ProtoInterval),
    Array(ProtoArray),
    List(ProtoRow),
    Dict(ProtoDict),
    Numeric(ProtoNumeric),
    Uuid(Vec<u8>),
}

NB: Proto oneof ids 1..=15 get encoded in 1 byte and so we should reserve them for the datum types we expect to be most popular.

Null, False, and True are all likely to be frequent, but the encoded length is exactly the same if they’re here or in ProtoDatumOther. In general, anything that can be encoded purely as a proto enum variant (i.e. doesn’t have a payload) is better off that way. If we run out of 1-byte encodings of ProtoDatumOther, we can always add ProtoDatumOther2.

Variants

Other(i32)

Tuple Fields

0: i32

Int16(i32)

Tuple Fields

0: i32

Int32(i32)

Tuple Fields

0: i32

Int64(i64)

Tuple Fields

0: i64

Float32(f32)

Tuple Fields

0: f32

Float64(f64)

Tuple Fields

0: f64

Bytes(Vec<u8>)

Tuple Fields

0: Vec<u8>

String(String)

Tuple Fields

0: String

Don’t use 9-15 without truly understanding the NB above.

Date(ProtoDate)

Tuple Fields

0: ProtoDate

These get encoded with 2 bytes for the oneof id. It’s a pretty easy and low-debt migration to “bless” one of these into having a 1-byte id (fill in the new field on write, but check if either field is set on read). However, once a 1-byte id is used, it’s gone forever, so we’re conservative in handing them out.

Of these, I’d guess Timestamp and UUID are probably the first ones we’d bless followed by Date and Time.

Time(ProtoTime)

Tuple Fields

0: ProtoTime

Timestamp(ProtoTimestamp)

Tuple Fields

0: ProtoTimestamp

Interval(ProtoInterval)

Tuple Fields

0: ProtoInterval

Array(ProtoArray)

Tuple Fields

0: ProtoArray

List(ProtoRow)

Tuple Fields

0: ProtoRow

Dict(ProtoDict)

Tuple Fields

0: ProtoDict

Numeric(ProtoNumeric)

Tuple Fields

0: ProtoNumeric

Uuid(Vec<u8>)

Tuple Fields

0: Vec<u8>

Implementations

impl DatumType

pub fn encode<B>(&self, buf: &mut B) where
    B: BufMut, 

pub fn merge<B>(
    field: &mut Option<DatumType>,
    tag: u32,
    wire_type: WireType,
    buf: &mut B,
    ctx: DecodeContext
) -> Result<(), DecodeError> where
    B: Buf, 

pub fn encoded_len(&self) -> usize

Trait Implementations

impl Clone for DatumType

fn clone(&self) -> DatumType

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for DatumType

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

Formats the value using the given formatter.

impl PartialEq<DatumType> for DatumType

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

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

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

This method tests for !=.

impl StructuralPartialEq for DatumType