musli-core 0.1.4

Core traits and types for the Müsli serialization framework.
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
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102

use crate::Context;

use super::{Encode, Encoder, SequenceEncoder};

/// The default implementation of [`Encoder::encode_slice`].
#[inline]
pub fn default_encode_slice<E, T>(encoder: E, slice: impl AsRef<[T]>) -> Result<(), E::Error>
where
    E: Encoder,
    T: Encode<E::Mode>,
{
    let cx = encoder.cx();
    let slice = slice.as_ref();
    let mut seq = encoder.encode_sequence(slice.len())?;

    for (index, item) in slice.iter().enumerate() {
        cx.enter_sequence_index(index);
        seq.push(item)?;
        cx.leave_sequence_index();
    }

    seq.finish_sequence()
}

/// The default implementation of [`Encoder::encode_slices`].
#[inline]
pub fn default_encode_slices<E, T>(
    encoder: E,
    len: usize,
    slices: impl IntoIterator<Item: AsRef<[T]>>,
) -> Result<(), E::Error>
where
    E: Encoder,
    T: Encode<E::Mode>,
{
    let cx = encoder.cx();

    let mut seq = encoder.encode_sequence(len)?;

    let mut index = 0;

    for slice in slices {
        for item in slice.as_ref() {
            cx.enter_sequence_index(index);
            seq.push(item)?;
            cx.leave_sequence_index();
            index = index.wrapping_add(1);
        }
    }

    seq.finish_sequence()
}

/// The default implementation of [`SequenceEncoder::encode_slice`].
#[inline]
pub fn default_sequence_encode_slice<E, T>(
    seq: &mut E,
    slice: impl AsRef<[T]>,
) -> Result<(), E::Error>
where
    E: ?Sized + SequenceEncoder,
    T: Encode<E::Mode>,
{
    let cx = seq.cx();

    let mut index = 0usize;

    for value in slice.as_ref() {
        cx.enter_sequence_index(index);
        seq.push(value)?;
        cx.leave_sequence_index();
        index = index.wrapping_add(1);
    }

    Ok(())
}

/// The default implementation of [`SequenceEncoder::encode_slices`].
#[inline]
pub fn default_sequence_encode_slices<E, T>(
    seq: &mut E,
    slices: impl IntoIterator<Item: AsRef<[T]>>,
) -> Result<(), E::Error>
where
    E: ?Sized + SequenceEncoder,
    T: Encode<E::Mode>,
{
    let cx = seq.cx();

    let mut index = 0usize;

    for slice in slices {
        for value in slice.as_ref() {
            cx.enter_sequence_index(index);
            seq.push(value)?;
            cx.leave_sequence_index();
            index = index.wrapping_add(1);
        }
    }

    Ok(())
}