Struct Peek

pub struct Peek<'mem, 'facet, 'shape> { /* private fields */ }

Lets you read from a value (implements read-only ValueVTable proxies)

Implementations

impl<'mem, 'facet, 'shape> Peek<'mem, 'facet, 'shape>

pub fn new<T: Facet<'facet> + ?Sized>(t: &'mem T) -> Self

Creates a new PeekValue instance for a value of type T.

pub unsafe fn unchecked_new( data: impl Into<GenericPtr<'mem>>, shape: &'shape Shape<'shape>, ) -> Self

Creates a new PeekValue instance without checking the type.

Safety

This function is unsafe because it doesn’t check if the provided data and shape are compatible. The caller must ensure that the data is valid for the given shape.

pub fn vtable(&self) -> &'shape ValueVTable

Returns the vtable

pub fn id(&self) -> ValueId<'shape>

Returns a unique identifier for this value, usable for cycle detection

pub fn ptr_eq(&self, other: &Peek<'_, '_, '_>) -> bool

Returns true if the two values are pointer-equal

pub fn partial_eq(&self, other: &Peek<'_, '_, '_>) -> Option<bool>

Returns true if this scalar is equal to the other scalar

Returns

false if equality comparison is not supported for this scalar type

pub fn partial_cmp(&self, other: &Peek<'_, '_, '_>) -> Option<Option<Ordering>>

Compares this scalar with another and returns their ordering

Returns

None if comparison is not supported for this scalar type

pub fn hash<H: Hasher>(&self, hasher: &mut H) -> Result<(), ReflectError<'_>>

Hashes this scalar

Returns

Err if hashing is not supported for this scalar type, Ok otherwise

pub fn type_name(&self, f: &mut Formatter<'_>, opts: TypeNameOpts) -> Result

Returns the type name of this scalar

Arguments

• f - A mutable reference to a core::fmt::Formatter
• opts - The TypeNameOpts to use for formatting

Returns

The result of the type name formatting

pub const fn shape(&self) -> &'shape Shape<'shape>

Returns the shape

pub const fn data(&self) -> GenericPtr<'mem>

Returns the data

pub fn scalar_type(&self) -> Option<ScalarType>

Get the scalar type if set.

pub fn get<T: Facet<'facet>>(&self) -> Result<&T, ReflectError<'shape>>

Read the value from memory into a Rust value.

Panics

Panics if the shape doesn’t match the type T.

pub fn as_str(&self) -> Option<&'mem str>

Try to get the value as a string if it’s a string type Returns None if the value is not a string or couldn’t be extracted

pub fn as_bytes(&self) -> Option<&'mem [u8]>

Try to get the value as a byte slice if it’s a &u8 type Returns None if the value is not a byte slice or couldn’t be extracted

pub fn into_struct( self, ) -> Result<PeekStruct<'mem, 'facet, 'shape>, ReflectError<'shape>>

Tries to identify this value as a struct

pub fn into_enum( self, ) -> Result<PeekEnum<'mem, 'facet, 'shape>, ReflectError<'shape>>

Tries to identify this value as an enum

pub fn into_map( self, ) -> Result<PeekMap<'mem, 'facet, 'shape>, ReflectError<'shape>>

Tries to identify this value as a map

pub fn into_list( self, ) -> Result<PeekList<'mem, 'facet, 'shape>, ReflectError<'shape>>

Tries to identify this value as a list

pub fn into_list_like( self, ) -> Result<PeekListLike<'mem, 'facet, 'shape>, ReflectError<'shape>>

Tries to identify this value as a list, array or slice

pub fn into_smart_pointer( self, ) -> Result<PeekSmartPointer<'mem, 'facet, 'shape>, ReflectError<'shape>>

Tries to identify this value as a smart pointer

pub fn into_option( self, ) -> Result<PeekOption<'mem, 'facet, 'shape>, ReflectError<'shape>>

Tries to identify this value as an option

pub fn into_tuple( self, ) -> Result<PeekTuple<'mem, 'facet, 'shape>, ReflectError<'shape>>

Tries to identify this value as a tuple

pub fn innermost_peek(self) -> Self

Tries to return the innermost value — useful for serialization. For example, we serialize a NonZero<u8> the same as a u8. Similarly, we serialize a Utf8PathBuf the same as a `String.

Returns a Peek to the innermost value, unwrapping transparent wrappers recursively. For example, this will peel through newtype wrappers or smart pointers that have an inner.

Trait Implementations

impl<'mem, 'facet, 'shape> Clone for Peek<'mem, 'facet, 'shape>

fn clone(&self) -> Peek<'mem, 'facet, 'shape>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<'mem, 'facet, 'shape> Debug for Peek<'mem, 'facet, 'shape>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'mem, 'facet, 'shape> Display for Peek<'mem, 'facet, 'shape>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'mem, 'facet, 'shape> Hash for Peek<'mem, 'facet, 'shape>

fn hash<H: Hasher>(&self, hasher: &mut H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'mem, 'facet, 'shape> PartialEq for Peek<'mem, 'facet, 'shape>

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<'mem, 'facet, 'shape> PartialOrd for Peek<'mem, 'facet, 'shape>

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

fn lt(&self, other: &Rhs) -> bool

Tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Rhs) -> bool

Tests less than or equal to (for self and other) and is used by the <= operator.

fn gt(&self, other: &Rhs) -> bool

Tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Rhs) -> bool

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl<'mem, 'facet, 'shape> Copy for Peek<'mem, 'facet, 'shape>