use PhantomData;
use crate::;
/// A field view represents the field metadata stored in a [Field] plus it stores the underlying
/// storage data it operates on, either as a reference to a slice `&[u8]`, `&mut [u8]`, or as
/// an owning [Vec<u8>].
///
/// Since this API remembers the underlying storage data in a view object, you don't have to pass it
/// in each time you're accessing a field. If you rather prefer an API that does not do that,
/// take a look at the [Field] API.
///
/// # Example:
/// ```
/// use binary_layout::prelude::*;
///
/// define_layout!(my_layout, LittleEndian, {
/// field_one: u16,
/// another_field: [u8; 16],
/// something_else: u32,
/// tail: [u8],
/// });
///
/// fn func(storage_data: &mut [u8]) {
/// let mut view = my_layout::View::new(storage_data);
///
/// // read some data
/// let format_version_header: u16 = view.field_one().read();
/// // equivalent: let format_version_header = u16::from_le_bytes((&storage_data[0..2]).try_into().unwrap());
///
/// // write some data
/// view.something_else_mut().write(10);
/// // equivalent: data_slice[18..22].copy_from_slice(&10u32.to_le_bytes());
///
/// // access a data region
/// let tail: &[u8] = view.tail();
/// // equivalent: let tail: &[u8] = &data_slice[22..];
///
/// // and modify it
/// view.tail_mut()[..5].copy_from_slice(&[1, 2, 3, 4, 5]);
/// // equivalent: data_slice[18..22].copy_from_slice(&[1, 2, 3, 4, 5]);
/// }
/// ```