[−][src]Trait serde::ser::SerializeTuple

pub trait SerializeTuple {
    type Ok;
    type Error: Error;
    fn serialize_element<T: ?Sized>(
        &mut self, 
        value: &T
    ) -> Result<(), Self::Error>
    where
        T: Serialize;

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

Returned from Serializer::serialize_tuple.

Example use

use serde::ser::{Serialize, Serializer, SerializeTuple};

# mod fool {
#     trait Serialize {}
impl<A, B, C> Serialize for (A, B, C)
#     {}
# }
#
# struct Tuple3<A, B, C>(A, B, C);
#
# impl<A, B, C> Serialize for Tuple3<A, B, C>
where
    A: Serialize,
    B: Serialize,
    C: Serialize,
{
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        let mut tup = serializer.serialize_tuple(3)?;
        tup.serialize_element(&self.0)?;
        tup.serialize_element(&self.1)?;
        tup.serialize_element(&self.2)?;
        tup.end()
    }
}

# use std::marker::PhantomData;
#
# struct Array<T>(PhantomData<T>);
#
# impl<T> Array<T> {
#     fn len(&self) -> usize {
#         unimplemented!()
#     }
# }
#
# impl<'a, T> IntoIterator for &'a Array<T> {
#     type Item = &'a T;
#     type IntoIter = Box<Iterator<Item = &'a T>>;
#     fn into_iter(self) -> Self::IntoIter {
#         unimplemented!()
#     }
# }
#
use serde::ser::{Serialize, Serializer, SerializeTuple};

# mod fool {
#     trait Serialize {}
impl<T> Serialize for [T; 16]
#     {}
# }
#
# impl<T> Serialize for Array<T>
where
    T: Serialize,
{
    fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>
    where
        S: Serializer,
    {
        let mut seq = serializer.serialize_tuple(16)?;
        for element in self {
            seq.serialize_element(element)?;
        }
        seq.end()
    }
}

Example implementation

The example data format presented on the website demonstrates an implementation of SerializeTuple for a basic JSON data format.

Associated Types

type Ok

Must match the Ok type of our Serializer.

type Error: Error

Must match the Error type of our Serializer.

Loading content...

Required methods

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

Serialize a tuple element.

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

Finish serializing a tuple.

Loading content...

Implementors

impl<Ok, Error> SerializeTuple for Impossible<Ok, Error> where
    Error: Error, [src]

type Ok = Ok

type Error = Error

Loading content...