pub struct NonStrict;Expand description
Selects LEB128 decoding that accepts non-canonical integer encodings.
Use this zero-sized policy as the second type parameter of
crate::Leb128Codec or crate::ZigZagCodec when decoding
compatibility-sensitive input. Encoding remains canonical regardless of the
selected policy. Non-canonical representations are accepted only within the
target integer’s maximum decode width
(crate::Leb128Codec::MAX_DECODE_UNITS_PER_VALUE). The terminal payload
must still fit the target bit width. Over-width payloads and sequences that
remain unterminated at that maximum width are malformed; this policy does
not accept arbitrarily long encodings.
§Examples
use qubit_codec_binary::{Leb128Codec, NonStrict};
let input = [0x80, 0x00];
let (value, consumed) = unsafe {
Leb128Codec::<u16, NonStrict>::decode(&input, 0)
}
.expect("non-canonical zero should decode with the non-strict policy");
assert_eq!(0, value);
assert_eq!(2, consumed.get());use qubit_codec_binary::Leb128Codec;
use qubit_codec_binary::Leb128DecodeErrorKind;
use qubit_codec_binary::NonStrict;
let input = [0x80, 0x80, 0x00];
// SAFETY: The non-empty array provides the required first readable byte.
let error = unsafe { Leb128Codec::<u8, NonStrict>::decode(&input, 0) }
.expect_err("three bytes exceed the u8 decode width");
assert_eq!(Leb128DecodeErrorKind::Malformed, error.kind());
// SAFETY: The same array satisfies the decoder's readable-byte precondition.
let (value, consumed) = unsafe {
Leb128Codec::<u16, NonStrict>::decode(&input, 0)
}
.expect("the redundant zero fits the u16 decode width");
assert_eq!(0, value);
assert_eq!(3, consumed.get());Trait Implementations§
impl Copy for NonStrict
impl Eq for NonStrict
Source§impl Leb128DecodePolicy for NonStrict
impl Leb128DecodePolicy for NonStrict
impl StructuralPartialEq for NonStrict
Auto Trait Implementations§
impl Freeze for NonStrict
impl RefUnwindSafe for NonStrict
impl Send for NonStrict
impl Sync for NonStrict
impl Unpin for NonStrict
impl UnsafeUnpin for NonStrict
impl UnwindSafe for NonStrict
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more