2014-02-05 10:52:54 -06:00
|
|
|
// Copyright 2012-2014 The Rust Project Developers. See the COPYRIGHT
|
2012-12-10 22:37:21 -06:00
|
|
|
// file at the top-level directory of this distribution and at
|
|
|
|
// http://rust-lang.org/COPYRIGHT.
|
|
|
|
//
|
|
|
|
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
|
|
|
|
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
|
|
|
|
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
|
|
|
|
// option. This file may not be copied, modified, or distributed
|
|
|
|
// except according to those terms.
|
|
|
|
|
|
|
|
//! Support code for encoding and decoding types.
|
|
|
|
|
|
|
|
/*
|
|
|
|
Core encoding and decoding interfaces.
|
|
|
|
*/
|
|
|
|
|
2014-03-10 22:47:47 -05:00
|
|
|
use std::path;
|
2013-11-25 12:35:03 -06:00
|
|
|
use std::rc::Rc;
|
2014-07-04 07:24:50 -05:00
|
|
|
use std::cell::{Cell, RefCell};
|
2014-10-25 22:38:27 -05:00
|
|
|
use std::sync::Arc;
|
2012-12-23 16:41:37 -06:00
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
pub trait Encoder<E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
// Primitive types:
|
2014-03-18 12:58:26 -05:00
|
|
|
fn emit_nil(&mut self) -> Result<(), E>;
|
|
|
|
fn emit_uint(&mut self, v: uint) -> Result<(), E>;
|
|
|
|
fn emit_u64(&mut self, v: u64) -> Result<(), E>;
|
|
|
|
fn emit_u32(&mut self, v: u32) -> Result<(), E>;
|
|
|
|
fn emit_u16(&mut self, v: u16) -> Result<(), E>;
|
|
|
|
fn emit_u8(&mut self, v: u8) -> Result<(), E>;
|
|
|
|
fn emit_int(&mut self, v: int) -> Result<(), E>;
|
|
|
|
fn emit_i64(&mut self, v: i64) -> Result<(), E>;
|
|
|
|
fn emit_i32(&mut self, v: i32) -> Result<(), E>;
|
|
|
|
fn emit_i16(&mut self, v: i16) -> Result<(), E>;
|
|
|
|
fn emit_i8(&mut self, v: i8) -> Result<(), E>;
|
|
|
|
fn emit_bool(&mut self, v: bool) -> Result<(), E>;
|
|
|
|
fn emit_f64(&mut self, v: f64) -> Result<(), E>;
|
|
|
|
fn emit_f32(&mut self, v: f32) -> Result<(), E>;
|
|
|
|
fn emit_char(&mut self, v: char) -> Result<(), E>;
|
|
|
|
fn emit_str(&mut self, v: &str) -> Result<(), E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
|
|
|
|
// Compound types:
|
2014-12-06 13:30:22 -06:00
|
|
|
fn emit_enum<F>(&mut self, name: &str, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
|
|
|
|
fn emit_enum_variant<F>(&mut self, v_name: &str,
|
|
|
|
v_id: uint,
|
|
|
|
len: uint,
|
|
|
|
f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
fn emit_enum_variant_arg<F>(&mut self, a_idx: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
|
|
|
|
fn emit_enum_struct_variant<F>(&mut self, v_name: &str,
|
|
|
|
v_id: uint,
|
|
|
|
len: uint,
|
|
|
|
f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
fn emit_enum_struct_variant_field<F>(&mut self,
|
|
|
|
f_name: &str,
|
|
|
|
f_idx: uint,
|
|
|
|
f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
|
|
|
|
fn emit_struct<F>(&mut self, name: &str, len: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
fn emit_struct_field<F>(&mut self, f_name: &str, f_idx: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
|
|
|
|
fn emit_tuple<F>(&mut self, len: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
fn emit_tuple_arg<F>(&mut self, idx: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
|
|
|
|
fn emit_tuple_struct<F>(&mut self, name: &str, len: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
fn emit_tuple_struct_arg<F>(&mut self, f_idx: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
|
|
|
|
// Specialized types:
|
2014-12-06 13:30:22 -06:00
|
|
|
fn emit_option<F>(&mut self, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
2014-03-18 12:58:26 -05:00
|
|
|
fn emit_option_none(&mut self) -> Result<(), E>;
|
2014-12-06 13:30:22 -06:00
|
|
|
fn emit_option_some<F>(&mut self, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
|
2014-12-06 13:30:22 -06:00
|
|
|
fn emit_seq<F>(&mut self, len: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
fn emit_seq_elt<F>(&mut self, idx: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
|
2014-12-06 13:30:22 -06:00
|
|
|
fn emit_map<F>(&mut self, len: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
|
|
|
fn emit_map_elt_key<F>(&mut self, idx: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnMut(&mut Self) -> Result<(), E>;
|
|
|
|
fn emit_map_elt_val<F>(&mut self, idx: uint, f: F) -> Result<(), E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<(), E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
pub trait Decoder<E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
// Primitive types:
|
2014-03-18 12:58:26 -05:00
|
|
|
fn read_nil(&mut self) -> Result<(), E>;
|
|
|
|
fn read_uint(&mut self) -> Result<uint, E>;
|
|
|
|
fn read_u64(&mut self) -> Result<u64, E>;
|
|
|
|
fn read_u32(&mut self) -> Result<u32, E>;
|
|
|
|
fn read_u16(&mut self) -> Result<u16, E>;
|
|
|
|
fn read_u8(&mut self) -> Result<u8, E>;
|
|
|
|
fn read_int(&mut self) -> Result<int, E>;
|
|
|
|
fn read_i64(&mut self) -> Result<i64, E>;
|
|
|
|
fn read_i32(&mut self) -> Result<i32, E>;
|
|
|
|
fn read_i16(&mut self) -> Result<i16, E>;
|
|
|
|
fn read_i8(&mut self) -> Result<i8, E>;
|
|
|
|
fn read_bool(&mut self) -> Result<bool, E>;
|
|
|
|
fn read_f64(&mut self) -> Result<f64, E>;
|
|
|
|
fn read_f32(&mut self) -> Result<f32, E>;
|
|
|
|
fn read_char(&mut self) -> Result<char, E>;
|
2014-05-22 18:57:53 -05:00
|
|
|
fn read_str(&mut self) -> Result<String, E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
|
|
|
|
// Compound types:
|
2014-12-06 13:30:22 -06:00
|
|
|
fn read_enum<T, F>(&mut self, name: &str, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
|
|
|
|
fn read_enum_variant<T, F>(&mut self, names: &[&str], f: F) -> Result<T, E> where
|
2014-12-15 11:06:06 -06:00
|
|
|
F: FnMut(&mut Self, uint) -> Result<T, E>;
|
2014-12-06 13:30:22 -06:00
|
|
|
fn read_enum_variant_arg<T, F>(&mut self, a_idx: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
|
|
|
|
fn read_enum_struct_variant<T, F>(&mut self, names: &[&str], f: F) -> Result<T, E> where
|
2014-12-15 11:06:06 -06:00
|
|
|
F: FnMut(&mut Self, uint) -> Result<T, E>;
|
2014-12-06 13:30:22 -06:00
|
|
|
fn read_enum_struct_variant_field<T, F>(&mut self,
|
|
|
|
&f_name: &str,
|
|
|
|
f_idx: uint,
|
|
|
|
f: F)
|
|
|
|
-> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
|
|
|
|
fn read_struct<T, F>(&mut self, s_name: &str, len: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
fn read_struct_field<T, F>(&mut self,
|
|
|
|
f_name: &str,
|
|
|
|
f_idx: uint,
|
|
|
|
f: F)
|
|
|
|
-> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
|
|
|
|
fn read_tuple<T, F>(&mut self, len: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
fn read_tuple_arg<T, F>(&mut self, a_idx: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
|
|
|
|
fn read_tuple_struct<T, F>(&mut self, s_name: &str, len: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
fn read_tuple_struct_arg<T, F>(&mut self, a_idx: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
|
|
|
|
// Specialized types:
|
2014-12-06 13:30:22 -06:00
|
|
|
fn read_option<T, F>(&mut self, f: F) -> Result<T, E> where
|
2014-12-15 11:06:06 -06:00
|
|
|
F: FnMut(&mut Self, bool) -> Result<T, E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
|
2014-12-06 13:30:22 -06:00
|
|
|
fn read_seq<T, F>(&mut self, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self, uint) -> Result<T, E>;
|
|
|
|
fn read_seq_elt<T, F>(&mut self, idx: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
|
2014-12-06 13:30:22 -06:00
|
|
|
fn read_map<T, F>(&mut self, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self, uint) -> Result<T, E>;
|
|
|
|
fn read_map_elt_key<T, F>(&mut self, idx: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
|
|
|
fn read_map_elt_val<T, F>(&mut self, idx: uint, f: F) -> Result<T, E> where
|
|
|
|
F: FnOnce(&mut Self) -> Result<T, E>;
|
2014-07-30 21:35:32 -05:00
|
|
|
|
|
|
|
// Failure
|
|
|
|
fn error(&mut self, err: &str) -> E;
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
|
2014-11-06 10:25:09 -06:00
|
|
|
pub trait Encodable<S:Encoder<E>, E> for Sized? {
|
2014-03-18 12:58:26 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
pub trait Decodable<D:Decoder<E>, E> {
|
|
|
|
fn decode(d: &mut D) -> Result<Self, E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for uint {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_uint(*self)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for uint {
|
|
|
|
fn decode(d: &mut D) -> Result<uint, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_uint()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for u8 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_u8(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for u8 {
|
|
|
|
fn decode(d: &mut D) -> Result<u8, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_u8()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for u16 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_u16(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for u16 {
|
|
|
|
fn decode(d: &mut D) -> Result<u16, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_u16()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for u32 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_u32(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for u32 {
|
|
|
|
fn decode(d: &mut D) -> Result<u32, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_u32()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for u64 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_u64(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for u64 {
|
|
|
|
fn decode(d: &mut D) -> Result<u64, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_u64()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for int {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_int(*self)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for int {
|
|
|
|
fn decode(d: &mut D) -> Result<int, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_int()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for i8 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_i8(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for i8 {
|
|
|
|
fn decode(d: &mut D) -> Result<i8, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_i8()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for i16 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_i16(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for i16 {
|
|
|
|
fn decode(d: &mut D) -> Result<i16, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_i16()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for i32 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_i32(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for i32 {
|
|
|
|
fn decode(d: &mut D) -> Result<i32, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_i32()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for i64 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_i64(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for i64 {
|
|
|
|
fn decode(d: &mut D) -> Result<i64, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_i64()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-11-06 10:25:09 -06:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for str {
|
2014-03-18 12:58:26 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2014-11-06 10:25:09 -06:00
|
|
|
s.emit_str(self)
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-05-22 18:57:53 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for String {
|
2014-04-30 17:55:04 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2014-12-10 21:46:38 -06:00
|
|
|
s.emit_str(self[])
|
2014-04-30 17:55:04 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-05-22 18:57:53 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for String {
|
|
|
|
fn decode(d: &mut D) -> Result<String, E> {
|
2014-12-10 21:46:38 -06:00
|
|
|
d.read_str()
|
2014-04-30 17:55:04 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for f32 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_f32(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for f32 {
|
|
|
|
fn decode(d: &mut D) -> Result<f32, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_f32()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for f64 {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_f64(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for f64 {
|
|
|
|
fn decode(d: &mut D) -> Result<f64, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_f64()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for bool {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_bool(*self)
|
|
|
|
}
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for bool {
|
|
|
|
fn decode(d: &mut D) -> Result<bool, E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_bool()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for char {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-30 23:42:00 -05:00
|
|
|
s.emit_char(*self)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for char {
|
|
|
|
fn decode(d: &mut D) -> Result<char, E> {
|
2013-05-30 23:42:00 -05:00
|
|
|
d.read_char()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> Encodable<S, E> for () {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
s.emit_nil()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> Decodable<D, E> for () {
|
|
|
|
fn decode(d: &mut D) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
d.read_nil()
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-11-06 10:25:09 -06:00
|
|
|
impl<'a, E, S: Encoder<E>, Sized? T: Encodable<S, E>> Encodable<S, E> for &'a T {
|
2014-03-18 12:58:26 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
(**self).encode(s)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-11-06 10:25:09 -06:00
|
|
|
impl<E, S: Encoder<E>, Sized? T: Encodable<S, E>> Encodable<S, E> for Box<T> {
|
2014-03-18 12:58:26 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-05-01 19:54:54 -05:00
|
|
|
(**self).encode(s)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-11-06 10:25:09 -06:00
|
|
|
impl<E, D:Decoder<E>, T: Decodable<D, E>> Decodable<D, E> for Box<T> {
|
2014-05-05 20:56:44 -05:00
|
|
|
fn decode(d: &mut D) -> Result<Box<T>, E> {
|
2014-04-25 03:08:02 -05:00
|
|
|
Ok(box try!(Decodable::decode(d)))
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-11-06 10:25:09 -06:00
|
|
|
impl<E, D:Decoder<E>, T: Decodable<D, E>> Decodable<D, E> for Box<[T]> {
|
|
|
|
fn decode(d: &mut D) -> Result<Box<[T]>, E> {
|
|
|
|
let v: Vec<T> = try!(Decodable::decode(d));
|
|
|
|
Ok(v.into_boxed_slice())
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>,T:Encodable<S, E>> Encodable<S, E> for Rc<T> {
|
2013-11-25 12:35:03 -06:00
|
|
|
#[inline]
|
2014-03-18 12:58:26 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2014-03-21 00:10:44 -05:00
|
|
|
(**self).encode(s)
|
2013-11-25 12:35:03 -06:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>,T:Decodable<D, E>> Decodable<D, E> for Rc<T> {
|
2013-11-25 12:35:03 -06:00
|
|
|
#[inline]
|
2014-03-18 12:58:26 -05:00
|
|
|
fn decode(d: &mut D) -> Result<Rc<T>, E> {
|
|
|
|
Ok(Rc::new(try!(Decodable::decode(d))))
|
2013-11-25 12:35:03 -06:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-11-06 10:25:09 -06:00
|
|
|
impl<E, S:Encoder<E>,T:Encodable<S, E>> Encodable<S, E> for [T] {
|
2014-03-18 12:58:26 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-11-20 17:46:49 -06:00
|
|
|
s.emit_seq(self.len(), |s| {
|
2013-08-03 11:45:23 -05:00
|
|
|
for (i, e) in self.iter().enumerate() {
|
2014-03-18 12:58:26 -05:00
|
|
|
try!(s.emit_seq_elt(i, |s| e.encode(s)))
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
2014-03-18 12:58:26 -05:00
|
|
|
Ok(())
|
2013-11-20 17:46:49 -06:00
|
|
|
})
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>,T:Encodable<S, E>> Encodable<S, E> for Vec<T> {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2014-02-18 23:36:51 -06:00
|
|
|
s.emit_seq(self.len(), |s| {
|
|
|
|
for (i, e) in self.iter().enumerate() {
|
2014-03-18 12:58:26 -05:00
|
|
|
try!(s.emit_seq_elt(i, |s| e.encode(s)))
|
2014-02-18 23:36:51 -06:00
|
|
|
}
|
2014-03-18 12:58:26 -05:00
|
|
|
Ok(())
|
2014-02-18 23:36:51 -06:00
|
|
|
})
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>,T:Decodable<D, E>> Decodable<D, E> for Vec<T> {
|
|
|
|
fn decode(d: &mut D) -> Result<Vec<T>, E> {
|
2014-02-18 23:36:51 -06:00
|
|
|
d.read_seq(|d, len| {
|
2014-03-18 12:58:26 -05:00
|
|
|
let mut v = Vec::with_capacity(len);
|
|
|
|
for i in range(0, len) {
|
|
|
|
v.push(try!(d.read_seq_elt(i, |d| Decodable::decode(d))));
|
|
|
|
}
|
|
|
|
Ok(v)
|
2014-02-18 23:36:51 -06:00
|
|
|
})
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>,T:Encodable<S, E>> Encodable<S, E> for Option<T> {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2013-11-20 17:46:49 -06:00
|
|
|
s.emit_option(|s| {
|
2013-05-01 19:54:54 -05:00
|
|
|
match *self {
|
|
|
|
None => s.emit_option_none(),
|
|
|
|
Some(ref v) => s.emit_option_some(|s| v.encode(s)),
|
|
|
|
}
|
2013-11-20 17:46:49 -06:00
|
|
|
})
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>,T:Decodable<D, E>> Decodable<D, E> for Option<T> {
|
|
|
|
fn decode(d: &mut D) -> Result<Option<T>, E> {
|
2013-11-20 17:46:49 -06:00
|
|
|
d.read_option(|d, b| {
|
2013-05-04 16:25:41 -05:00
|
|
|
if b {
|
2014-03-18 12:58:26 -05:00
|
|
|
Ok(Some(try!(Decodable::decode(d))))
|
2013-05-04 16:25:41 -05:00
|
|
|
} else {
|
2014-03-18 12:58:26 -05:00
|
|
|
Ok(None)
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
2013-11-20 17:46:49 -06:00
|
|
|
})
|
2012-12-10 22:37:21 -06:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-11-14 11:18:10 -06:00
|
|
|
macro_rules! peel {
|
|
|
|
($name:ident, $($other:ident,)*) => (tuple! { $($other,)* })
|
|
|
|
}
|
2014-03-22 23:58:51 -05:00
|
|
|
|
libserialize: tuple-arity should be provided to `Decoder::read_tuple`
Currently `Decoder` implementations are not provided the tuple arity as
a parameter to `read_tuple`. This forces all encoder/decoder combos to
serialize the arity along with the elements. Tuple-arity is always known
statically at the decode site, because it is part of the type of the
tuple, so it could instead be provided as an argument to `read_tuple`,
as it is to `read_struct`.
The upside to this is that serialized tuples could become smaller in
encoder/decoder implementations which choose not to serialize type
(arity) information. For example, @TyOverby's
[binary-encode](https://github.com/TyOverby/binary-encode) format is
currently forced to serialize the tuple-arity along with every tuple,
despite the information being statically known at the decode site.
A downside to this change is that the tuple-arity of serialized tuples
can no longer be automatically checked during deserialization. However,
for formats which do serialize the tuple-arity, either explicitly (rbml)
or implicitly (json), this check can be added to the `read_tuple` method.
The signature of `Deserialize::read_tuple` and
`Deserialize::read_tuple_struct` are changed, and thus binary
backwards-compatibility is broken. This change does *not* force
serialization formats to change, and thus does not break decoding values
serialized prior to this change.
[breaking-change]
2014-09-27 16:19:19 -05:00
|
|
|
/// Evaluates to the number of identifiers passed to it, for example: `count_idents!(a, b, c) == 3
|
|
|
|
macro_rules! count_idents {
|
|
|
|
() => { 0u };
|
|
|
|
($_i:ident $(, $rest:ident)*) => { 1 + count_idents!($($rest),*) }
|
|
|
|
}
|
|
|
|
|
2014-11-14 11:18:10 -06:00
|
|
|
macro_rules! tuple {
|
2014-03-22 23:58:51 -05:00
|
|
|
() => ();
|
|
|
|
( $($name:ident,)+ ) => (
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>,$($name:Decodable<D, E>),*> Decodable<D,E> for ($($name,)*) {
|
2014-07-18 07:45:17 -05:00
|
|
|
#[allow(non_snake_case)]
|
2014-03-18 12:58:26 -05:00
|
|
|
fn decode(d: &mut D) -> Result<($($name,)*), E> {
|
libserialize: tuple-arity should be provided to `Decoder::read_tuple`
Currently `Decoder` implementations are not provided the tuple arity as
a parameter to `read_tuple`. This forces all encoder/decoder combos to
serialize the arity along with the elements. Tuple-arity is always known
statically at the decode site, because it is part of the type of the
tuple, so it could instead be provided as an argument to `read_tuple`,
as it is to `read_struct`.
The upside to this is that serialized tuples could become smaller in
encoder/decoder implementations which choose not to serialize type
(arity) information. For example, @TyOverby's
[binary-encode](https://github.com/TyOverby/binary-encode) format is
currently forced to serialize the tuple-arity along with every tuple,
despite the information being statically known at the decode site.
A downside to this change is that the tuple-arity of serialized tuples
can no longer be automatically checked during deserialization. However,
for formats which do serialize the tuple-arity, either explicitly (rbml)
or implicitly (json), this check can be added to the `read_tuple` method.
The signature of `Deserialize::read_tuple` and
`Deserialize::read_tuple_struct` are changed, and thus binary
backwards-compatibility is broken. This change does *not* force
serialization formats to change, and thus does not break decoding values
serialized prior to this change.
[breaking-change]
2014-09-27 16:19:19 -05:00
|
|
|
let len: uint = count_idents!($($name),*);
|
|
|
|
d.read_tuple(len, |d| {
|
2014-03-22 23:58:51 -05:00
|
|
|
let mut i = 0;
|
2014-03-18 12:58:26 -05:00
|
|
|
let ret = ($(try!(d.read_tuple_arg({ i+=1; i-1 }, |d| -> Result<$name,E> {
|
2014-03-22 23:58:51 -05:00
|
|
|
Decodable::decode(d)
|
2014-03-18 12:58:26 -05:00
|
|
|
})),)*);
|
|
|
|
return Ok(ret);
|
2013-11-20 17:46:49 -06:00
|
|
|
})
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
}
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>,$($name:Encodable<S, E>),*> Encodable<S, E> for ($($name,)*) {
|
2014-07-18 07:45:17 -05:00
|
|
|
#[allow(non_snake_case)]
|
2014-03-18 12:58:26 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
2014-03-22 23:58:51 -05:00
|
|
|
let ($(ref $name,)*) = *self;
|
|
|
|
let mut n = 0;
|
|
|
|
$(let $name = $name; n += 1;)*
|
|
|
|
s.emit_tuple(n, |s| {
|
|
|
|
let mut i = 0;
|
2014-09-24 01:45:56 -05:00
|
|
|
$(try!(s.emit_tuple_arg({ i+=1; i-1 }, |s| $name.encode(s)));)*
|
2014-03-18 12:58:26 -05:00
|
|
|
Ok(())
|
2013-11-20 17:46:49 -06:00
|
|
|
})
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
}
|
2014-11-14 11:18:10 -06:00
|
|
|
peel! { $($name,)* }
|
2014-03-22 23:58:51 -05:00
|
|
|
)
|
2014-11-14 11:18:10 -06:00
|
|
|
}
|
2013-05-01 19:54:54 -05:00
|
|
|
|
2014-03-22 23:58:51 -05:00
|
|
|
tuple! { T0, T1, T2, T3, T4, T5, T6, T7, T8, T9, T10, T11, }
|
2013-05-01 19:54:54 -05:00
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S: Encoder<E>> Encodable<S, E> for path::posix::Path {
|
|
|
|
fn encode(&self, e: &mut S) -> Result<(), E> {
|
2014-03-10 22:47:47 -05:00
|
|
|
self.as_vec().encode(e)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D: Decoder<E>> Decodable<D, E> for path::posix::Path {
|
|
|
|
fn decode(d: &mut D) -> Result<path::posix::Path, E> {
|
2014-05-04 01:34:26 -05:00
|
|
|
let bytes: Vec<u8> = try!(Decodable::decode(d));
|
2014-03-18 12:58:26 -05:00
|
|
|
Ok(path::posix::Path::new(bytes))
|
2014-03-10 22:47:47 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S: Encoder<E>> Encodable<S, E> for path::windows::Path {
|
|
|
|
fn encode(&self, e: &mut S) -> Result<(), E> {
|
2014-03-10 22:47:47 -05:00
|
|
|
self.as_vec().encode(e)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D: Decoder<E>> Decodable<D, E> for path::windows::Path {
|
|
|
|
fn decode(d: &mut D) -> Result<path::windows::Path, E> {
|
2014-05-04 01:34:26 -05:00
|
|
|
let bytes: Vec<u8> = try!(Decodable::decode(d));
|
2014-03-18 12:58:26 -05:00
|
|
|
Ok(path::windows::Path::new(bytes))
|
2014-03-10 22:47:47 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-07-04 07:24:50 -05:00
|
|
|
impl<E, S: Encoder<E>, T: Encodable<S, E> + Copy> Encodable<S, E> for Cell<T> {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
|
|
|
self.get().encode(s)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<E, D: Decoder<E>, T: Decodable<D, E> + Copy> Decodable<D, E> for Cell<T> {
|
|
|
|
fn decode(d: &mut D) -> Result<Cell<T>, E> {
|
|
|
|
Ok(Cell::new(try!(Decodable::decode(d))))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
// FIXME: #15036
|
|
|
|
// Should use `try_borrow`, returning a
|
|
|
|
// `encoder.error("attempting to Encode borrowed RefCell")`
|
|
|
|
// from `encode` when `try_borrow` returns `None`.
|
|
|
|
|
|
|
|
impl<E, S: Encoder<E>, T: Encodable<S, E>> Encodable<S, E> for RefCell<T> {
|
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
|
|
|
self.borrow().encode(s)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<E, D: Decoder<E>, T: Decodable<D, E>> Decodable<D, E> for RefCell<T> {
|
|
|
|
fn decode(d: &mut D) -> Result<RefCell<T>, E> {
|
|
|
|
Ok(RefCell::new(try!(Decodable::decode(d))))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-10-17 13:00:02 -05:00
|
|
|
impl<E, S:Encoder<E>, T:Encodable<S, E>> Encodable<S, E> for Arc<T> {
|
2014-10-25 22:38:27 -05:00
|
|
|
fn encode(&self, s: &mut S) -> Result<(), E> {
|
|
|
|
(**self).encode(s)
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
|
|
|
impl<E, D:Decoder<E>,T:Decodable<D, E>+Send+Sync> Decodable<D, E> for Arc<T> {
|
|
|
|
fn decode(d: &mut D) -> Result<Arc<T>, E> {
|
|
|
|
Ok(Arc::new(try!(Decodable::decode(d))))
|
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2012-12-10 22:37:21 -06:00
|
|
|
// ___________________________________________________________________________
|
|
|
|
// Helper routines
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
pub trait EncoderHelpers<E> {
|
2014-12-06 13:30:22 -06:00
|
|
|
fn emit_from_vec<T, F>(&mut self, v: &[T], f: F) -> Result<(), E> where
|
|
|
|
F: FnMut(&mut Self, &T) -> Result<(), E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, S:Encoder<E>> EncoderHelpers<E> for S {
|
2014-12-06 13:30:22 -06:00
|
|
|
fn emit_from_vec<T, F>(&mut self, v: &[T], mut f: F) -> Result<(), E> where
|
|
|
|
F: FnMut(&mut S, &T) -> Result<(), E>,
|
|
|
|
{
|
2013-11-20 17:46:49 -06:00
|
|
|
self.emit_seq(v.len(), |this| {
|
2013-08-03 11:45:23 -05:00
|
|
|
for (i, e) in v.iter().enumerate() {
|
2014-03-18 12:58:26 -05:00
|
|
|
try!(this.emit_seq_elt(i, |this| {
|
2013-05-01 19:54:54 -05:00
|
|
|
f(this, e)
|
2014-03-18 12:58:26 -05:00
|
|
|
}));
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
2014-03-18 12:58:26 -05:00
|
|
|
Ok(())
|
2013-11-20 17:46:49 -06:00
|
|
|
})
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
pub trait DecoderHelpers<E> {
|
2014-12-06 13:30:22 -06:00
|
|
|
fn read_to_vec<T, F>(&mut self, f: F) -> Result<Vec<T>, E> where
|
|
|
|
F: FnMut(&mut Self) -> Result<T, E>;
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
|
2014-03-18 12:58:26 -05:00
|
|
|
impl<E, D:Decoder<E>> DecoderHelpers<E> for D {
|
2014-12-06 13:30:22 -06:00
|
|
|
fn read_to_vec<T, F>(&mut self, mut f: F) -> Result<Vec<T>, E> where F:
|
|
|
|
FnMut(&mut D) -> Result<T, E>,
|
|
|
|
{
|
2013-11-20 17:46:49 -06:00
|
|
|
self.read_seq(|this, len| {
|
2014-04-17 17:59:07 -05:00
|
|
|
let mut v = Vec::with_capacity(len);
|
2014-03-18 12:58:26 -05:00
|
|
|
for i in range(0, len) {
|
|
|
|
v.push(try!(this.read_seq_elt(i, |this| f(this))));
|
|
|
|
}
|
2014-05-04 01:34:26 -05:00
|
|
|
Ok(v)
|
2013-11-20 17:46:49 -06:00
|
|
|
})
|
2013-05-01 19:54:54 -05:00
|
|
|
}
|
|
|
|
}
|