jcers 0.1.2

jce in rust
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

#![doc = include_str!("../README.md")]

mod de;
mod err;
mod ser;
#[cfg(test)]
mod test;
mod util;
mod value;

use std::fmt::LowerHex;

use bytes::Buf;
pub use de::{Jce, JceGet};
pub use err::{JceError, JceResult};
#[cfg(feature = "derive")]
#[cfg_attr(docrs, doc(cfg(feature = "derive")))]
pub use jcers_proc::{JceGet, JcePut};
pub use ser::{JceMut, JcePut};
pub use util::{JceHead, JceType};
pub use value::*;

/// Read data from Buf
///
/// ## Example
/// ```rust
/// use bytes::Bytes;
/// let mut buf = Bytes::from(vec![0x00u8, 0x01u8]);
/// let v: JceValue = from_buf(&mut buf).unwrap();
/// assert_eq!(v, JceValue::Byte(0x01u8));
/// ```
pub fn from_buf<B, T>(buf: &mut B) -> JceResult<T>
where
    B: Buf + LowerHex,
    T: JceGet,
{
    let mut jce = Jce::new(buf);
    T::jce_get(&mut jce)
}


/// Read data as a anonymous struct and get the given tag value
pub fn from_buf_with_tag<B, T>(buf: &mut B, tag: u8) -> JceResult<T>
where
    B: Buf + LowerHex,
    T: JceGet,
{
    let mut jce = Jce::new(buf);
    T::get_by_tag(&mut jce, tag)
}

/// Unbox a JceStruct and get the given tag value
pub fn from_buf_with_tag_unbox<B, T>(buf: &mut B, tag: u8) -> JceResult<T>
where
    B: Buf + LowerHex,
    T: JceGet,
{
    let mut jce = Jce::new(buf);
    jce.read_head();
    let mut jce = jce.sub_jce();
    T::get_by_tag(&mut jce, tag)
}

#[test]
fn test_from_buf() {
    use bytes::Bytes;
    let mut buf = Bytes::from(vec![0x00u8, 0x01u8]);
    let v: JceValue = from_buf(&mut buf).unwrap();
    assert_eq!(v, JceValue::U8(0x01u8));
}