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
/*******************************************************************************
*
* Copyright (c) 2026 Haixing Hu.
*
* SPDX-License-Identifier: Apache-2.0
*
* Licensed under the Apache License, Version 2.0.
*
******************************************************************************/
//! Decode context passed to buffered decoder policy hooks.
/// Context for one codec decode attempt inside a buffered decoder engine.
#[derive(Clone, Copy, Debug, Eq, Hash, PartialEq)]
pub struct DecodeContext {
/// Absolute source index where this `transcode` call starts.
pub input_start: usize,
/// Absolute source index where the attempted value starts.
pub input_index: usize,
/// Absolute output index where this `transcode` call starts.
pub output_start: usize,
/// Absolute output index where the next decoded value would be written.
pub output_index: usize,
/// Units visible to the codec from `input_index`.
pub available: usize,
}
impl DecodeContext {
/// Creates a decode context.
///
/// # Parameters
///
/// - `input_start`: Absolute source index where this `transcode` call starts.
/// - `input_index`: Absolute source index where the attempted value starts.
/// - `output_start`: Absolute output index where this `transcode` call starts.
/// - `output_index`: Absolute output index where the next value would be written.
/// - `available`: Units visible to the codec from `input_index`.
///
/// # Returns
///
/// Returns a decode context.
#[must_use]
#[inline(always)]
pub const fn new(
input_start: usize,
input_index: usize,
output_start: usize,
output_index: usize,
available: usize,
) -> Self {
Self {
input_start,
input_index,
output_start,
output_index,
available,
}
}
/// Returns input units consumed since this `transcode` call started.
///
/// # Returns
///
/// Returns `input_index - input_start`.
#[must_use]
#[inline(always)]
pub const fn input_used(self) -> usize {
self.input_index - self.input_start
}
/// Returns output values written since this `transcode` call started.
///
/// # Returns
///
/// Returns `output_index - output_start`.
#[must_use]
#[inline(always)]
pub const fn output_written(self) -> usize {
self.output_index - self.output_start
}
}