Struct serde_pickle::de::Deserializer [−][src]
pub struct Deserializer<R: Read> { /* fields omitted */ }
Expand description
Decodes pickle streams into values.
Implementations
Construct a new Deserializer.
Reset internal state, allowing reading multiple pickle dump calls from a single stream.
By default (value_)from_reader
closes the input stream. It is possible
to deserialize multiple pickle objects from a single stream by
implementing a custom reader and resetting the internal state before
reading the next value.
Example
Using reset_memo
inside a custom deserializer to deserialize multiple
objects from a single stream.
struct PickleReader<R: Read + Sized>
{
de: Deserializer<R>,
}
impl<R: Read + Sized> PickleReader<R>
{
fn new(reader: R) -> PickleReader<R> {
PickleReader {
de: Deserializer::new(reader, DeOptions::new()),
}
}
pub fn read_object<'de, T: Deserialize<'de>>(&mut self) -> Result<T> {
self.de.reset_memo();
let value = Deserialize::deserialize(&mut self.de)?;
Ok(value)
}
}
let input = vec![0x80, 0x04, 0x95, 0x09, 0x00, 0x00, 0x00, 0x00,
0x00, 0x00, 0x00, 0x8c, 0x05, 0x48, 0x65, 0x6c,
0x6c, 0x6f, 0x94, 0x2e, 0x80, 0x04, 0x95, 0x0a,
0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x8c,
0x06, 0x70, 0x69, 0x63, 0x6b, 0x6c, 0x65, 0x94,
0x2e, 0x00];
let mut reader = PickleReader::new(std::io::Cursor::new(input.as_slice()));
let string1: String = reader.read_object().unwrap();
let string2: String = reader.read_object().unwrap();
assert_eq!(&string1, "Hello");
assert_eq!(&string2, "pickle");
Decode a Value from this pickle. This is different from going through
the generic serde deserialize
, since it preserves some types that are
not in the serde data model, such as big integers.
Trait Implementations
The error type that can be returned if some error occurs during deserialization. Read more
Require the Deserializer
to figure out how to drive the visitor based
on what data type is in the input. Read more
Hint that the Deserialize
type is expecting an optional value. Read more
Hint that the Deserialize
type is expecting a newtype struct with a
particular name. Read more
fn deserialize_enum<V: Visitor<'de>>(
self,
_name: &'static str,
_variants: &'static [&'static str],
visitor: V
) -> Result<V::Value>
fn deserialize_enum<V: Visitor<'de>>(
self,
_name: &'static str,
_variants: &'static [&'static str],
visitor: V
) -> Result<V::Value>
Hint that the Deserialize
type is expecting an enum value with a
particular name and possible variants. Read more
Hint that the Deserialize
type is expecting a bool
value.
Hint that the Deserialize
type is expecting a u8
value.
Hint that the Deserialize
type is expecting a u16
value.
Hint that the Deserialize
type is expecting a u32
value.
Hint that the Deserialize
type is expecting a u64
value.
Hint that the Deserialize
type is expecting an i8
value.
Hint that the Deserialize
type is expecting an i16
value.
Hint that the Deserialize
type is expecting an i32
value.
Hint that the Deserialize
type is expecting an i64
value.
Hint that the Deserialize
type is expecting a f32
value.
Hint that the Deserialize
type is expecting a f64
value.
Hint that the Deserialize
type is expecting a char
value.
Hint that the Deserialize
type is expecting a string value and does
not benefit from taking ownership of buffered data owned by the
Deserializer
. Read more
Hint that the Deserialize
type is expecting a string value and would
benefit from taking ownership of buffered data owned by the
Deserializer
. Read more
Hint that the Deserialize
type is expecting a unit value.
Hint that the Deserialize
type is expecting a sequence of values.
Hint that the Deserialize
type is expecting a byte array and does not
benefit from taking ownership of buffered data owned by the
Deserializer
. Read more
Hint that the Deserialize
type is expecting a byte array and would
benefit from taking ownership of buffered data owned by the
Deserializer
. Read more
Hint that the Deserialize
type is expecting a map of key-value pairs.
Hint that the Deserialize
type is expecting a tuple struct with a
particular name and number of fields. Read more
fn deserialize_struct<V>(
self,
name: &'static str,
fields: &'static [&'static str],
visitor: V
) -> Result<V::Value, Self::Error> where
V: Visitor<'de>,
fn deserialize_struct<V>(
self,
name: &'static str,
fields: &'static [&'static str],
visitor: V
) -> Result<V::Value, Self::Error> where
V: Visitor<'de>,
Hint that the Deserialize
type is expecting a struct with a particular
name and fields. Read more
Hint that the Deserialize
type is expecting the name of a struct
field or the discriminant of an enum variant. Read more
Hint that the Deserialize
type is expecting a sequence of values and
knows how many values there are without looking at the serialized data. Read more
Hint that the Deserialize
type needs to deserialize a value whose type
doesn’t matter because it is ignored. Read more
Hint that the Deserialize
type is expecting a unit struct with a
particular name. Read more
Hint that the Deserialize
type is expecting an i128
value. Read more
Hint that the Deserialize
type is expecting an u128
value. Read more
Determine whether Deserialize
implementations should expect to
deserialize their human-readable form. Read more