9 //! Wrappers around raw, unstructured bytes.
16 /// A source of unstructured data.
18 /// An `Unstructured` helps `Arbitrary` implementations interpret raw data
21 /// string" (the raw data wrapped by an `Unstructured`) results in a small
25 /// `Unstructured` is deterministic: given the same raw data, the same series of
27 /// like running out of memory). However, `Unstructured` does not guarantee
31 /// You shouldn't generally need to use an `Unstructured` unless you are writing
42 /// Below is what translating the fuzzer's raw input into an `Unstructured` and
47 /// use arbitrary::{Arbitrary, Unstructured};
61 /// // Wrap it in an `Unstructured`.
62 /// let mut unstructured = Unstructured::new(raw_data);
65 /// if let Ok(rgb) = Rgb::arbitrary(&mut unstructured) {
72 pub struct Unstructured<'a> {  struct
76 impl<'a> Unstructured<'a> {  impl
77     /// Create a new `Unstructured` from the given raw data.
82     /// use arbitrary::Unstructured;
84     /// let u = Unstructured::new(&[1, 2, 3, 4]);
87         Unstructured { data }  in new()
96     /// use arbitrary::{Arbitrary, Unstructured};
98     /// let mut u = Unstructured::new(&[1, 2, 3]);
113     /// Is the underlying unstructured data exhausted?
115     /// `unstructured.is_empty()` is the same as `unstructured.len() == 0`.
120     /// use arbitrary::{Arbitrary, Unstructured};
122     /// let mut u = Unstructured::new(&[1, 2, 3, 4]);
148     /// use arbitrary::{Arbitrary, Unstructured};
160     /// let mut u = Unstructured::new(&[1, 2, 3, 4]);
188     /// use arbitrary::{Arbitrary, Result, Unstructured};
199     ///     fn arbitrary(u: &mut Unstructured<'a>) -> Result<Self> {
285     /// use arbitrary::{Arbitrary, Unstructured};
287     /// let mut u = Unstructured::new(&[1, 2, 3, 4]);
315             "`arbitrary::Unstructured::int_in_range` requires a non-empty range"  in int_in_range_impl()
388     /// use arbitrary::Unstructured;
390     /// let mut u = Unstructured::new(&[1, 2, 3, 4, 5, 6, 7, 8, 9, 0]);
401     /// use arbitrary::Unstructured;
403     /// let mut u = Unstructured::new(&[1, 2, 3, 4, 5, 6, 7, 8, 9, 0]);
428     /// use arbitrary::Unstructured;
430     /// let mut u = Unstructured::new(&[1, 2, 3, 4, 5, 6, 7, 8, 9, 0]);
461     /// use arbitrary::Unstructured;
463     /// let mut u = Unstructured::new(&[1, 2, 3, 4, 5, 6, 7, 8, 9, 0]);
478     /// use arbitrary::Unstructured;
480     /// let mut u = Unstructured::new(&[1, 2, 3, 4, 5, 6, 7, 8, 9, 0]);
509     /// use arbitrary::Unstructured;
512     /// let mut u = Unstructured::new(&my_data);
537     /// If this `Unstructured` does not have enough underlying data to fill the
543     /// use arbitrary::Unstructured;
545     /// let mut u = Unstructured::new(&[1, 2, 3, 4]);
578     /// use arbitrary::Unstructured;
580     /// let mut u = Unstructured::new(&[1, 2, 3, 4]);
605     /// use arbitrary::Unstructured;
607     /// let u = Unstructured::new(&[1, 2, 3]);
627     /// use arbitrary::Unstructured;
629     /// let mut u = Unstructured::new(&[1, 2, 3]);
668     /// The function is given this `Unstructured` so that it can continue to
688     /// use arbitrary::{Result, Unstructured};
702     /// fn arbitrary_types_context(u: &mut Unstructured) -> Result<Vec<Type>> {
749 /// Utility iterator produced by [`Unstructured::arbitrary_iter`]
751     u: &'b mut Unstructured<'a>,
767 /// Utility iterator produced by [`Unstructured::arbitrary_take_rest_iter`]
769     u: Unstructured<'a>,
911         let mut u = Unstructured::new(&[1, 2, 3, 4, 5, 6, 7, 8, 9, 6]);  in test_byte_size()
918         let mut u = Unstructured::new(&v);  in test_byte_size()
926         let mut u = Unstructured::new(&[1, 2, 3, 4, 5, 6, 7, 8, 9, 6]);  in int_in_range_of_one()
935         let mut u = Unstructured::new(&[1, 2]);  in int_in_range_uses_minimal_amount_of_bytes()
939         let mut u = Unstructured::new(&[1, 2]);  in int_in_range_uses_minimal_amount_of_bytes()
943         let mut u = Unstructured::new(&[1]);  in int_in_range_uses_minimal_amount_of_bytes()
953             let mut u = Unstructured::new(&input);  in int_in_range_in_bounds()
957             let mut u = Unstructured::new(&input);  in int_in_range_in_bounds()
976             let mut u = Unstructured::new(&input);  in int_in_range_covers_unsigned_range()
980             let mut u = Unstructured::new(&input);  in int_in_range_covers_unsigned_range()
984             let mut u = Unstructured::new(&input);  in int_in_range_covers_unsigned_range()
988             let mut u = Unstructured::new(&input);  in int_in_range_covers_unsigned_range()
1022             let mut u = Unstructured::new(&input);  in int_in_range_covers_signed_range()
1026             let mut u = Unstructured::new(&input);  in int_in_range_covers_signed_range()
1030             let mut u = Unstructured::new(&input);  in int_in_range_covers_signed_range()
1034             let mut u = Unstructured::new(&input);  in int_in_range_covers_signed_range()