Struct TopLevelRowSink 

struct TopLevelRowSink<B>(B);

Wraps the sink that every top-level row is appended into. The row builders signal a missing value (value and typed_value both NULL) by calling append_null, and this wrapper gives that signal its top-level meaning: Variant::Null, because the non-nullable output value column cannot hold a physical NULL. Array-level NULL rows are appended before the sink is built, so they never reach it. Nested builders created via try_new_object/try_new_list are returned unwrapped, so nested missing values keep their own semantics, e.g. [ObjectFieldBuilder] omits the field.

Tuple Fields

0: B

Trait Implementations

impl<B: VariantBuilderExt> VariantBuilderExt for TopLevelRowSink<B>

type State<'a> = <B as VariantBuilderExt>::State<'a> where Self: 'a

The builder specific state used by nested builders

fn append_null(&mut self)

Appends a NULL value to this builder. The semantics depend on the implementation, but will often translate to appending a [Variant::Null] value.

fn append_value<'m, 'v>(&mut self, value: impl Into<Variant<'m, 'v>>)

Appends a new variant value to this builder. See e.g. [VariantBuilder::append_value].

fn try_new_list(&mut self) -> Result<ListBuilder<'_, Self::State<'_>>>

Creates a nested list builder. See e.g. [VariantBuilder::new_list]. Returns an error if the nested builder cannot be created, see e.g. [ObjectBuilder::try_new_list].

fn try_new_object(&mut self) -> Result<ObjectBuilder<'_, Self::State<'_>>>

Creates a nested object builder. See e.g. [VariantBuilder::new_object]. Returns an error if the nested builder cannot be created, see e.g. [ObjectBuilder::try_new_object].

fn new_list(&mut self) -> ListBuilder<'_, Self::State<'_>>

Creates a nested list builder. See e.g. [VariantBuilder::new_list]. Panics if the nested builder cannot be created, see e.g. [ObjectBuilder::new_list].

fn new_object(&mut self) -> ObjectBuilder<'_, Self::State<'_>>

Creates a nested object builder. See e.g. [VariantBuilder::new_object]. Panics if the nested builder cannot be created, see e.g. [ObjectBuilder::new_object].