Struct ValueWriter 

pub struct ValueWriter<'a> { /* private fields */ }

Writes an individual value to a column.

Implementations

impl<'a> ValueWriter<'a>

pub fn column_type(&self) -> &'a DataTypeNode

The data type of the target column.

pub fn write_fixed(&mut self, bytes: &[u8]) -> Result<(), ValueWriteError>

Write a value to a fixed-width column.

Errors

• ValueWriteError::IncorrectMethod if the data type is not fixed-width.
• ValueWriteError::InvalidLength if the data type is a different width than the number of bytes written.

pub fn write_string( &mut self, string_bytes: &[u8], ) -> Result<(), ValueWriteError>

Write a string value to the column.

ClickHouse strings are not required to be UTF-8, so this method accepts arbitrary bytes.

Note

Types writing to a FixedString column should check the declared length through Self::column_type() and call Self::write_fixed() instead.

pub fn write_null(&mut self) -> Result<(), ValueWriteError>

Write a null value to the column.

Errors

• ValueWriteError::UnexpectedNull if the column type is not Nullable(_).

pub fn write_array<T>(&mut self) -> Result<ArrayWriter<'_, T>, ArrayWriteError>

where T: Encode,

Begin writing an array to the column.

See ArrayWriter for details.

Errors

• ArrayWriteError::NotAnArray if the column type is not Array(_).
• ArrayWriteError::IncompatibleType if T is not compatible with the column type, as determined by Encode::compatible().

pub fn write_tuple(&mut self) -> Result<TupleWriter<'_>, TupleWriteError>

Begin writing a tuple to the column.

See TupleWriter for details.

Errors

• TupleWriteError::NotATuple if the column type is not Tuple(...) or Nullable(Tuple(...)) (experimental type).

pub fn write_map<K, V>(&mut self) -> Result<MapWriter<'_, K, V>, MapWriteError>

where K: Encode, V: Encode,

Begin writing a map to the column.

See MapWriter for details.

Errors

• MapWriteError::NotAMap if the column type is not Map(...).
• MapWriteError::IncompatibleKeyType if K is not compatible with the map’s key type, according to Encode::compatible().
• MapWriteError::IncompatibleValueType if V is not compatible with the map’s value type, according to Encode::compatible().