codec_cbor/general/
cursor.rs1use super::error::{error, CborError, ErrorReason};
6use super::limits::{Budget, Limits};
7use super::profile::LengthPolicy;
8use super::receipt::{check_input, Frame};
9use super::scan::{add, scan, tail};
10
11pub struct Cursor<'a> {
15 input: &'a [u8],
16 offset: usize,
17 consumed: &'a [u8],
18 remaining: &'a [u8],
19 budget: Budget,
20 lengths: LengthPolicy,
21 failed: bool,
22}
23
24impl<'a> Cursor<'a> {
25 pub fn new(input: &'a [u8], limits: Limits, lengths: LengthPolicy) -> Result<Self, CborError> {
27 super::profile::ensure_lengths_supported(lengths)?;
28 check_input(input, limits)?;
29 Ok(Self {
30 input,
31 offset: 0,
32 consumed: input.get(..0).ok_or(error(ErrorReason::Truncated))?,
33 remaining: input,
34 budget: Budget::new(limits),
35 lengths,
36 failed: false,
37 })
38 }
39 #[must_use]
41 pub fn consumed_bytes(&self) -> &'a [u8] {
42 self.consumed
43 }
44 #[must_use]
46 pub fn remaining_bytes(&self) -> &'a [u8] {
47 self.remaining
48 }
49}
50
51impl<'a> Iterator for Cursor<'a> {
52 type Item = Result<Frame<'a>, CborError>;
53 fn next(&mut self) -> Option<Self::Item> {
54 if self.failed || self.offset == self.input.len() {
55 return None;
56 }
57 let result = (|| {
58 let frame = scan(
59 tail(self.input, self.offset)?,
60 &mut self.budget,
61 0,
62 None,
63 true,
64 self.lengths,
65 )?;
66 let offset = add(self.offset, frame.received_bytes().len())?;
67 let consumed = self
68 .input
69 .get(..offset)
70 .ok_or(error(ErrorReason::Truncated))?;
71 let remaining = tail(self.input, offset)?;
72 self.offset = offset;
73 self.consumed = consumed;
74 self.remaining = remaining;
75 Ok(frame)
76 })();
77 if result.is_err() {
78 self.failed = true;
79 }
80 Some(result)
81 }
82}
83
84impl core::iter::FusedIterator for Cursor<'_> {}