Struct dbn::record_ref::RecordRef

pub struct RecordRef<'a> { /* private fields */ }

A wrapper around a non-owning immutable reference to a DBN record. This wrapper allows for mixing of record types and schemas, and runtime record polymorphism.

Implementations

impl<'a> RecordRef<'a>

pub unsafe fn new(buffer: &'a [u8]) -> Self

Constructs a new reference to the DBN record in buffer.

Safety

buffer should begin with a RecordHeader and contain a type implementing HasRType.

pub unsafe fn unchecked_from_header(header: *const RecordHeader) -> Self

Constructs a new reference to the DBN record.

Safety

header must point to a valid DBN record.

pub fn header(&self) -> &RecordHeader

Returns a reference to the RecordHeader of the referenced record.

pub fn has<T: HasRType>(&self) -> bool

Returns true if the object points to a record of type T.

pub fn record_size(&self) -> usize

Returns the size of the record in bytes.

pub fn rtype(&self) -> Result<RType>

Tries to convert the raw rtype into an enum which is useful for exhaustive pattern matching.

Errors

This function returns an error if the rtype field does not contain a valid, known RType.

pub fn get<T: HasRType>(&self) -> Option<&'a T>

Returns a reference to the underlying record of type T or None if it points to another record type.

Note: for safety, this method calls has::<T>(). To avoid a duplicate check, use get_unchecked().

Panics

This function will panic if the rtype indicates it’s of type T but the encoded length of the record is less than the size of T.

pub unsafe fn get_unchecked<T: HasRType>(&self) -> &T

Returns a reference to the underlying record of type T without checking if this object references a record of type T.

For a safe alternative, see get().

Safety

The caller needs to validate this object points to a T.

Trait Implementations

impl<'a> AsRef<[u8]> for RecordRef<'a>

fn as_ref(&self) -> &[u8]

Converts this type into a shared reference of the (usually inferred) input type.

impl<'a> Clone for RecordRef<'a>

fn clone(&self) -> RecordRef<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for RecordRef<'a>

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

Formats the value using the given formatter.

impl Send for RecordRef<'_>

impl Sync for RecordRef<'_>