pub enum Datum<'a> {
Show 27 variants False, True, Int16(i16), Int32(i32), Int64(i64), UInt8(u8), UInt16(u16), UInt32(u32), UInt64(u64), Float32(OrderedFloat<f32>), Float64(OrderedFloat<f64>), Date(Date), Time(NaiveTime), Timestamp(CheckedTimestamp<NaiveDateTime>), TimestampTz(CheckedTimestamp<DateTime<Utc>>), Interval(Interval), Bytes(&'a [u8]), String(&'a str), Array(Array<'a>), List(DatumList<'a>), Map(DatumMap<'a>), Numeric(OrderedDecimal<Numeric>), JsonNull, Uuid(Uuid), MzTimestamp(Timestamp), Dummy, Null,
}
Expand description

A single value.

Note that Datum must always derive Eq to enforce equality with repr::Row.

Variants

False

The false boolean value.

True

The true boolean value.

Int16(i16)

A 16-bit signed integer.

Int32(i32)

A 32-bit signed integer.

Int64(i64)

A 64-bit signed integer.

UInt8(u8)

An 8-bit unsigned integer.

UInt16(u16)

An 16-bit unsigned integer.

UInt32(u32)

A 32-bit unsigned integer.

UInt64(u64)

A 64-bit unsigned integer.

Float32(OrderedFloat<f32>)

A 32-bit floating point number.

Float64(OrderedFloat<f64>)

A 64-bit floating point number.

Date(Date)

A date.

Time(NaiveTime)

A time.

Timestamp(CheckedTimestamp<NaiveDateTime>)

A date and time, without a timezone.

TimestampTz(CheckedTimestamp<DateTime<Utc>>)

A date and time, with a timezone.

Interval(Interval)

A span of time.

Bytes(&'a [u8])

A sequence of untyped bytes.

String(&'a str)

A sequence of Unicode codepoints encoded as UTF-8.

Array(Array<'a>)

Unlike Datum::List, arrays are like tensors and are not permitted to be ragged.

List(DatumList<'a>)

A sequence of Datums.

Unlike Datum::Array, lists are permitted to be ragged.

Map(DatumMap<'a>)

A mapping from string keys to Datums.

Numeric(OrderedDecimal<Numeric>)

An exact decimal number, possibly with a fractional component, with up to 39 digits of precision.

JsonNull

An unknown value within a JSON-typed Datum.

This variant is distinct from Datum::Null as a null datum is distinct from a non-null datum that contains the JSON value null.

Uuid(Uuid)

A universally unique identifier.

MzTimestamp(Timestamp)

Dummy

A placeholder value.

Dummy values are never meant to be observed. Many operations on Datum panic if called on this variant.

Dummies are useful as placeholders in e.g. a Vec<Datum>, where it is known that a certain element of the vector is never observed and therefore needn’t be computed, but where some Datum must still be provided to maintain the shape of the vector. While any valid datum could be used for this purpose, having a dedicated variant makes it obvious when these optimizations have gone awry. If we used e.g. Datum::Null, an unexpected Datum::Null could indicate any number of problems: bad user data, bad function metadata, or a bad optimization.

Null

An unknown value.

Implementations

Reports whether this datum is null (i.e., is Datum::Null).

Unwraps the boolean value within this datum.

Panics

Panics if the datum is not Datum::False or Datum::True.

Unwraps the 16-bit integer value within this datum.

Panics

Panics if the datum is not Datum::Int16.

Unwraps the 32-bit integer value within this datum.

Panics

Panics if the datum is not Datum::Int32.

Unwraps the 64-bit integer value within this datum.

Panics

Panics if the datum is not Datum::Int64.

Unwraps the 8-bit unsigned integer value within this datum.

Panics

Panics if the datum is not Datum::UInt8.

Unwraps the 16-bit unsigned integer value within this datum.

Panics

Panics if the datum is not Datum::UInt16.

Unwraps the 32-bit unsigned integer value within this datum.

Panics

Panics if the datum is not Datum::UInt32.

Unwraps the 64-bit unsigned integer value within this datum.

Panics

Panics if the datum is not Datum::UInt64.

Unwraps the 32-bit floating-point value within this datum.

Panics

Panics if the datum is not Datum::Float32.

Unwraps the 64-bit floating-point value within this datum.

Panics

Panics if the datum is not Datum::Float64.

Unwraps the date value within this datum.

Panics

Panics if the datum is not Datum::Date.

Unwraps the time vaqlue within this datum.

Panics

Panics if the datum is not Datum::Time.

Unwraps the timestamp value within this datum.

Panics

Panics if the datum is not Datum::Timestamp.

Unwraps the timestamptz value within this datum.

Panics

Panics if the datum is not Datum::TimestampTz.

Unwraps the interval value within this datum.

Panics

Panics if the datum is not Datum::Interval.

Unwraps the string value within this datum.

Panics

Panics if the datum is not Datum::String.

Unwraps the bytes value within this datum.

Panics

Panics if the datum is not Datum::Bytes.

Unwraps the uuid value within this datum.

Panics

Panics if the datum is not Datum::Uuid.

Unwraps the array value within this datum.

Panics

Panics if the datum is not Datum::Array.

Unwraps the list value within this datum.

Panics

Panics if the datum is not Datum::List.

Unwraps the map value within this datum.

Panics

Panics if the datum is not Datum::Map.

Unwraps the numeric value within this datum.

Panics

Panics if the datum is not Datum::Numeric.

Unwraps the mz_repr::Timestamp value within this datum.

Panics

Panics if the datum is not Datum::MzTimestamp.

Reports whether this datum is an instance of the specified column type.

Trait Implementations

Returns a copy of the value. Read more
Performs copy-assignment from source. Read more
Whether this Rust type can represent NULL values
Try to convert a Result whose Ok variant is a Datum into this native Rust type (Self). If it fails the error variant will contain the original result. Read more
Convert this Rust type into a Result containing a Datum, or an error
Formats the value using the given formatter. Read more
Formats the value using the given formatter. Read more
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Converts to this type from the input type.
Feeds this value into the given Hasher. Read more
Feeds a slice of this type into the given Hasher. Read more
This method returns an Ordering between self and other. Read more
Compares and returns the maximum of two values. Read more
Compares and returns the minimum of two values. Read more
Restrict a value to a certain interval. Read more
This method tests for self and other values to be equal, and is used by ==. Read more
This method tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason. Read more
This method returns an ordering between self and other values if one exists. Read more
This method tests less than (for self and other) and is used by the < operator. Read more
This method tests less than or equal to (for self and other) and is used by the <= operator. Read more
This method tests greater than (for self and other) and is used by the > operator. Read more
This method tests greater than or equal to (for self and other) and is used by the >= operator. Read more

This implementation of serialize is designed to be able to print out Datums in a human-readable way in JSON. This implementation may not suit other serialization purposes.

Serialize this value into the given Serde serializer. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.

Auto Trait Implementations

Blanket Implementations

Gets the TypeId of self. Read more
Immutably borrows from an owned value. Read more
Mutably borrows from an owned value. Read more
Formats an object with the “alternative” format ({:#}) and returns it.
Compare self to key and return true if they are equal.

Returns the argument unchanged.

Attaches the provided Context to this type, returning a WithContext wrapper. Read more
Attaches the current Context to this type, returning a WithContext wrapper. Read more
The type of the output value.
A well-distributed integer derived from the data.
Instruments this type with the provided Span, returning an Instrumented wrapper. Read more
Instruments this type with the current Span, returning an Instrumented wrapper. Read more

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Wrap the input message T in a tonic::Request
Upcasts this ProgressEventTimestamp to Any. Read more
Returns the name of the concrete type of this object. Read more
Should always be Self
The resulting type after obtaining ownership.
Creates owned data from borrowed data, usually by cloning. Read more
Uses borrowed data to replace owned data, usually by cloning. Read more
Converts the given value to a String. Read more
The type returned in the event of a conversion error.
Performs the conversion.
The type returned in the event of a conversion error.
Performs the conversion.
Attaches the provided Subscriber to this type, returning a WithDispatch wrapper. Read more
Attaches the current default Subscriber to this type, returning a WithDispatch wrapper. Read more