Struct FieldWriter

pub struct FieldWriter<'a, W: Write> { /* private fields */ }

Struct that knows how to write a record

You give it the values you want to write and it writes them. The order and type of value must match the one given when creating the TableWriter, otherwise an error will occur.

Implementations

impl<'a, W: Write> FieldWriter<'a, W>

pub fn next_field_name(&mut self) -> Option<&'a str>

Returns the name of the next field that is expected to be written

pub fn write_next_field_value<T: WritableAsDbaseField>( &mut self, field_value: &T, ) -> Result<(), FieldIOError>

Writes the given field_value to the record.

Notes

If the corresponding FieldType of the the field_value type (T) does not match the expected type an error is returned.

Values for which the number of bytes written would exceed the specified field_length (if it had to be specified) will be truncated

Trying to write more values than was declared when creating the writer will cause an EndOfRecord error.

Trait Implementations

impl<'a, W: Write> SerializeMap for &mut FieldWriter<'a, W>

type Ok = ()

Must match the Ok type of our Serializer.

type Error = FieldIOError

Must match the Error type of our Serializer.

fn serialize_key<T>(&mut self, _key: &T) -> Result<(), Self::Error>

where T: Serialize + ?Sized,

Serialize a map key.

fn serialize_value<T>(&mut self, _value: &T) -> Result<(), Self::Error>

where T: Serialize + ?Sized,

Serialize a map value.

fn end(self) -> Result<Self::Ok, Self::Error>

Finish serializing a map.

fn serialize_entry<K, V>( &mut self, key: &K, value: &V, ) -> Result<(), Self::Error>

where K: Serialize + ?Sized, V: Serialize + ?Sized,

Serialize a map entry consisting of a key and a value.

impl<'a, W: Write> SerializeSeq for &mut FieldWriter<'a, W>

type Ok = ()

Must match the Ok type of our Serializer.

type Error = FieldIOError

Must match the Error type of our Serializer.

fn serialize_element<T>(&mut self, value: &T) -> Result<(), Self::Error>

where T: Serialize + ?Sized,

Serialize a sequence element.

fn end(self) -> Result<Self::Ok, Self::Error>

Finish serializing a sequence.

impl<'a, W: Write> SerializeStruct for &mut FieldWriter<'a, W>

type Ok = ()

Must match the Ok type of our Serializer.

type Error = FieldIOError

Must match the Error type of our Serializer.

fn serialize_field<T>( &mut self, _key: &'static str, value: &T, ) -> Result<(), Self::Error>

where T: Serialize + ?Sized,

Serialize a struct field.

fn end(self) -> Result<Self::Ok, Self::Error>

Finish serializing a struct.

fn skip_field(&mut self, key: &'static str) -> Result<(), Self::Error>

Indicate that a struct field has been skipped.

impl<'a, W: Write> SerializeStructVariant for &mut FieldWriter<'a, W>

type Ok = ()

Must match the Ok type of our Serializer.

type Error = FieldIOError

Must match the Error type of our Serializer.

fn serialize_field<T>( &mut self, _key: &'static str, _value: &T, ) -> Result<(), Self::Error>

where T: Serialize + ?Sized,

Serialize a struct variant field.

fn end(self) -> Result<Self::Ok, Self::Error>

Finish serializing a struct variant.

fn skip_field(&mut self, key: &'static str) -> Result<(), Self::Error>

Indicate that a struct variant field has been skipped.

impl<'a, W: Write> SerializeTuple for &mut FieldWriter<'a, W>

type Ok = ()

Must match the Ok type of our Serializer.

type Error = FieldIOError

Must match the Error type of our Serializer.

fn serialize_element<T>(&mut self, value: &T) -> Result<(), Self::Error>

where T: Serialize + ?Sized,

Serialize a tuple element.

fn end(self) -> Result<Self::Ok, Self::Error>

Finish serializing a tuple.

impl<'a, W: Write> SerializeTupleStruct for &mut FieldWriter<'a, W>

type Ok = ()

Must match the Ok type of our Serializer.

type Error = FieldIOError

Must match the Error type of our Serializer.

fn serialize_field<T>(&mut self, value: &T) -> Result<(), Self::Error>

where T: Serialize + ?Sized,

Serialize a tuple struct field.

fn end(self) -> Result<Self::Ok, Self::Error>

Finish serializing a tuple struct.

impl<'a, W: Write> SerializeTupleVariant for &mut FieldWriter<'a, W>

type Ok = ()

Must match the Ok type of our Serializer.

type Error = FieldIOError

Must match the Error type of our Serializer.

fn serialize_field<T>(&mut self, _value: &T) -> Result<(), Self::Error>

where T: Serialize + ?Sized,

Serialize a tuple variant field.

fn end(self) -> Result<Self::Ok, Self::Error>

Finish serializing a tuple variant.

impl<'a, W: Write> Serializer for &mut FieldWriter<'a, W>

type Ok = ()

The output type produced by this Serializer during successful serialization. Most serializers that produce text or binary output should set Ok = () and serialize into an io::Write or buffer contained within the Serializer instance. Serializers that build in-memory data structures may be simplified by using Ok to propagate the data structure around.

type Error = FieldIOError

The error type when some error occurs during serialization.

type SerializeSeq = &mut FieldWriter<'a, W>

Type returned from serialize_seq for serializing the content of the sequence.

type SerializeTuple = &mut FieldWriter<'a, W>

Type returned from serialize_tuple for serializing the content of the tuple.

type SerializeTupleStruct = &mut FieldWriter<'a, W>

Type returned from serialize_tuple_struct for serializing the content of the tuple struct.

type SerializeTupleVariant = &mut FieldWriter<'a, W>

Type returned from serialize_tuple_variant for serializing the content of the tuple variant.

type SerializeMap = &mut FieldWriter<'a, W>

Type returned from serialize_map for serializing the content of the map.

type SerializeStruct = &mut FieldWriter<'a, W>

Type returned from serialize_struct for serializing the content of the struct.

type SerializeStructVariant = &mut FieldWriter<'a, W>

Type returned from serialize_struct_variant for serializing the content of the struct variant.

fn serialize_bool(self, v: bool) -> Result<Self::Ok, Self::Error>

Serialize a bool value.

fn serialize_i8(self, _v: i8) -> Result<Self::Ok, Self::Error>

Serialize an i8 value.

fn serialize_i16(self, _v: i16) -> Result<Self::Ok, Self::Error>

Serialize an i16 value.

fn serialize_i32(self, v: i32) -> Result<Self::Ok, Self::Error>

Serialize an i32 value.

fn serialize_i64(self, _v: i64) -> Result<Self::Ok, Self::Error>

Serialize an i64 value.

fn serialize_u8(self, _v: u8) -> Result<Self::Ok, Self::Error>

Serialize a u8 value.

fn serialize_u16(self, _v: u16) -> Result<Self::Ok, Self::Error>

Serialize a u16 value.

fn serialize_u32(self, _v: u32) -> Result<Self::Ok, Self::Error>

Serialize a u32 value.

fn serialize_u64(self, _v: u64) -> Result<Self::Ok, Self::Error>

Serialize a u64 value.

fn serialize_f32(self, v: f32) -> Result<Self::Ok, Self::Error>

Serialize an f32 value.

fn serialize_f64(self, v: f64) -> Result<Self::Ok, Self::Error>

Serialize an f64 value.

fn serialize_char(self, _v: char) -> Result<Self::Ok, Self::Error>

Serialize a character.

fn serialize_str(self, v: &str) -> Result<Self::Ok, Self::Error>

Serialize a &str.

fn serialize_bytes(self, v: &[u8]) -> Result<Self::Ok, Self::Error>

Serialize a chunk of raw byte data.

fn serialize_none(self) -> Result<Self::Ok, Self::Error>

Serialize a None value.

fn serialize_some<T>(self, value: &T) -> Result<Self::Ok, Self::Error>

where T: Serialize + ?Sized,

Serialize a Some(T) value.

fn serialize_unit(self) -> Result<Self::Ok, Self::Error>

Serialize a () value.

fn serialize_unit_struct( self, _name: &'static str, ) -> Result<Self::Ok, Self::Error>

Serialize a unit struct like struct Unit or PhantomData<T>.

fn serialize_unit_variant( self, _name: &'static str, _variant_index: u32, _variant: &'static str, ) -> Result<Self::Ok, Self::Error>

Serialize a unit variant like E::A in enum E { A, B }.

fn serialize_newtype_struct<T>( self, _name: &'static str, value: &T, ) -> Result<Self::Ok, Self::Error>

where T: Serialize + ?Sized,

Serialize a newtype struct like struct Millimeters(u8).

fn serialize_newtype_variant<T>( self, _name: &'static str, _variant_index: u32, _variant: &'static str, _value: &T, ) -> Result<Self::Ok, Self::Error>

where T: Serialize + ?Sized,

Serialize a newtype variant like E::N in enum E { N(u8) }.

fn serialize_seq( self, _len: Option<usize>, ) -> Result<Self::SerializeSeq, Self::Error>

Begin to serialize a variably sized sequence. This call must be followed by zero or more calls to serialize_element, then a call to end.

fn serialize_tuple( self, len: usize, ) -> Result<Self::SerializeTuple, Self::Error>

Begin to serialize a statically sized sequence whose length will be known at deserialization time without looking at the serialized data. This call must be followed by zero or more calls to serialize_element, then a call to end.

fn serialize_tuple_struct( self, _name: &'static str, len: usize, ) -> Result<Self::SerializeTupleStruct, Self::Error>

Begin to serialize a tuple struct like struct Rgb(u8, u8, u8). This call must be followed by zero or more calls to serialize_field, then a call to end.

fn serialize_tuple_variant( self, _name: &'static str, _variant_index: u32, _variant: &'static str, _len: usize, ) -> Result<Self::SerializeTupleVariant, Self::Error>

Begin to serialize a tuple variant like E::T in enum E { T(u8, u8) }. This call must be followed by zero or more calls to serialize_field, then a call to end.

fn serialize_map( self, _len: Option<usize>, ) -> Result<Self::SerializeMap, Self::Error>

Begin to serialize a map. This call must be followed by zero or more calls to serialize_key and serialize_value, then a call to end.

fn serialize_struct( self, _name: &'static str, len: usize, ) -> Result<Self::SerializeStruct, Self::Error>

Begin to serialize a struct like struct Rgb { r: u8, g: u8, b: u8 }. This call must be followed by zero or more calls to serialize_field, then a call to end.

fn serialize_struct_variant( self, _name: &'static str, _variant_index: u32, _variant: &'static str, _len: usize, ) -> Result<Self::SerializeStructVariant, Self::Error>

Begin to serialize a struct variant like E::S in enum E { S { r: u8, g: u8, b: u8 } }. This call must be followed by zero or more calls to serialize_field, then a call to end.

fn collect_str<T>(self, _value: &T) -> Result<Self::Ok, Self::Error>

where T: Display + ?Sized,

Serialize a string produced by an implementation of Display.

fn serialize_i128(self, v: i128) -> Result<Self::Ok, Self::Error>

Serialize an i128 value.

fn serialize_u128(self, v: u128) -> Result<Self::Ok, Self::Error>

Serialize a u128 value.

fn collect_seq<I>(self, iter: I) -> Result<Self::Ok, Self::Error>

where I: IntoIterator, <I as IntoIterator>::Item: Serialize,

Collect an iterator as a sequence.

fn collect_map<K, V, I>(self, iter: I) -> Result<Self::Ok, Self::Error>

where K: Serialize, V: Serialize, I: IntoIterator<Item = (K, V)>,

Collect an iterator as a map.

fn is_human_readable(&self) -> bool

Determine whether Serialize implementations should serialize in human-readable form.