xref: /aosp_15_r20/external/pigweed/pw_varint/stream.cc (revision 61c4878ac05f98d0ceed94b57d316916de578985)
1*61c4878aSAndroid Build Coastguard Worker // Copyright 2021 The Pigweed Authors
2*61c4878aSAndroid Build Coastguard Worker //
3*61c4878aSAndroid Build Coastguard Worker // Licensed under the Apache License, Version 2.0 (the "License"); you may not
4*61c4878aSAndroid Build Coastguard Worker // use this file except in compliance with the License. You may obtain a copy of
5*61c4878aSAndroid Build Coastguard Worker // the License at
6*61c4878aSAndroid Build Coastguard Worker //
7*61c4878aSAndroid Build Coastguard Worker //     https://www.apache.org/licenses/LICENSE-2.0
8*61c4878aSAndroid Build Coastguard Worker //
9*61c4878aSAndroid Build Coastguard Worker // Unless required by applicable law or agreed to in writing, software
10*61c4878aSAndroid Build Coastguard Worker // distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
11*61c4878aSAndroid Build Coastguard Worker // WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
12*61c4878aSAndroid Build Coastguard Worker // License for the specific language governing permissions and limitations under
13*61c4878aSAndroid Build Coastguard Worker // the License.
14*61c4878aSAndroid Build Coastguard Worker 
15*61c4878aSAndroid Build Coastguard Worker #include "pw_varint/stream.h"
16*61c4878aSAndroid Build Coastguard Worker 
17*61c4878aSAndroid Build Coastguard Worker #include <cstddef>
18*61c4878aSAndroid Build Coastguard Worker #include <cstdint>
19*61c4878aSAndroid Build Coastguard Worker 
20*61c4878aSAndroid Build Coastguard Worker #include "pw_span/span.h"
21*61c4878aSAndroid Build Coastguard Worker #include "pw_status/status_with_size.h"
22*61c4878aSAndroid Build Coastguard Worker #include "pw_stream/stream.h"
23*61c4878aSAndroid Build Coastguard Worker #include "pw_varint/varint.h"
24*61c4878aSAndroid Build Coastguard Worker 
25*61c4878aSAndroid Build Coastguard Worker namespace pw {
26*61c4878aSAndroid Build Coastguard Worker namespace varint {
27*61c4878aSAndroid Build Coastguard Worker 
Read(stream::Reader & reader,int64_t * output,size_t max_size)28*61c4878aSAndroid Build Coastguard Worker StatusWithSize Read(stream::Reader& reader, int64_t* output, size_t max_size) {
29*61c4878aSAndroid Build Coastguard Worker   uint64_t value = 0;
30*61c4878aSAndroid Build Coastguard Worker   StatusWithSize count = Read(reader, &value, max_size);
31*61c4878aSAndroid Build Coastguard Worker   if (!count.ok()) {
32*61c4878aSAndroid Build Coastguard Worker     return count;
33*61c4878aSAndroid Build Coastguard Worker   }
34*61c4878aSAndroid Build Coastguard Worker 
35*61c4878aSAndroid Build Coastguard Worker   *output = ZigZagDecode(value);
36*61c4878aSAndroid Build Coastguard Worker   return count;
37*61c4878aSAndroid Build Coastguard Worker }
38*61c4878aSAndroid Build Coastguard Worker 
Read(stream::Reader & reader,uint64_t * output,size_t max_size)39*61c4878aSAndroid Build Coastguard Worker StatusWithSize Read(stream::Reader& reader, uint64_t* output, size_t max_size) {
40*61c4878aSAndroid Build Coastguard Worker   uint64_t value = 0;
41*61c4878aSAndroid Build Coastguard Worker   size_t count = 0;
42*61c4878aSAndroid Build Coastguard Worker 
43*61c4878aSAndroid Build Coastguard Worker   while (true) {
44*61c4878aSAndroid Build Coastguard Worker     if (count >= varint::kMaxVarint64SizeBytes) {
45*61c4878aSAndroid Build Coastguard Worker       // Varint can't fit a uint64_t, this likely means we're reading binary
46*61c4878aSAndroid Build Coastguard Worker       // data that is not actually a varint.
47*61c4878aSAndroid Build Coastguard Worker       return StatusWithSize::DataLoss(count);
48*61c4878aSAndroid Build Coastguard Worker     }
49*61c4878aSAndroid Build Coastguard Worker 
50*61c4878aSAndroid Build Coastguard Worker     if (count >= max_size) {
51*61c4878aSAndroid Build Coastguard Worker       // Varint didn't fit within the range given; return OutOfRange() if
52*61c4878aSAndroid Build Coastguard Worker       // max_size was 0, but DataLoss if we were reading something we thought
53*61c4878aSAndroid Build Coastguard Worker       // was going to be a varint.
54*61c4878aSAndroid Build Coastguard Worker       return count > 0 ? StatusWithSize::DataLoss(count)
55*61c4878aSAndroid Build Coastguard Worker                        : StatusWithSize::OutOfRange();
56*61c4878aSAndroid Build Coastguard Worker     }
57*61c4878aSAndroid Build Coastguard Worker 
58*61c4878aSAndroid Build Coastguard Worker     std::byte b;
59*61c4878aSAndroid Build Coastguard Worker     if (auto result = reader.Read(span(&b, 1)); !result.ok()) {
60*61c4878aSAndroid Build Coastguard Worker       if (count > 0 && result.status().IsOutOfRange()) {
61*61c4878aSAndroid Build Coastguard Worker         // Status::OutOfRange on the first byte means we tried to read a varint
62*61c4878aSAndroid Build Coastguard Worker         // when we reached the end of file. But after the first byte it means we
63*61c4878aSAndroid Build Coastguard Worker         // failed to decode a varint we were in the middle of, and that's not
64*61c4878aSAndroid Build Coastguard Worker         // a normal error condition.
65*61c4878aSAndroid Build Coastguard Worker         return StatusWithSize::DataLoss(count);
66*61c4878aSAndroid Build Coastguard Worker       }
67*61c4878aSAndroid Build Coastguard Worker       return StatusWithSize(result.status(), count);
68*61c4878aSAndroid Build Coastguard Worker     }
69*61c4878aSAndroid Build Coastguard Worker 
70*61c4878aSAndroid Build Coastguard Worker     value |= static_cast<uint64_t>(b & std::byte(0b01111111)) << (7 * count);
71*61c4878aSAndroid Build Coastguard Worker     ++count;
72*61c4878aSAndroid Build Coastguard Worker 
73*61c4878aSAndroid Build Coastguard Worker     // MSB == 0 indicates last byte of the varint.
74*61c4878aSAndroid Build Coastguard Worker     if ((b & std::byte(0b10000000)) == std::byte(0)) {
75*61c4878aSAndroid Build Coastguard Worker       break;
76*61c4878aSAndroid Build Coastguard Worker     }
77*61c4878aSAndroid Build Coastguard Worker   }
78*61c4878aSAndroid Build Coastguard Worker 
79*61c4878aSAndroid Build Coastguard Worker   *output = value;
80*61c4878aSAndroid Build Coastguard Worker   return StatusWithSize(count);
81*61c4878aSAndroid Build Coastguard Worker }
82*61c4878aSAndroid Build Coastguard Worker 
83*61c4878aSAndroid Build Coastguard Worker }  // namespace varint
84*61c4878aSAndroid Build Coastguard Worker }  // namespace pw
85