Struct read_fonts::FontData

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

A reference to raw binary font data.

This is a wrapper around a byte slice, that provides convenience methods for parsing and validating that data.

Implementations

impl<'a> FontData<'a>

pub const fn new(bytes: &'a [u8]) -> Self

Create a new FontData with these bytes.

You generally don’t need to do this? It is handled for you when loading data from disk, but may be useful in tests.

pub fn len(&self) -> usize

The length of the data, in bytes

pub fn is_empty(&self) -> bool

true if the data has a length of zero bytes.

pub fn split_off(&self, pos: usize) -> Option<FontData<'a>>

Returns self[pos..]

pub fn take_up_to(&mut self, pos: usize) -> Option<FontData<'a>>

returns self[..pos], and updates self to = self[pos..];

pub fn slice(&self, range: impl RangeBounds<usize>) -> Option<FontData<'a>>

pub fn read_at<T: ReadScalar>(&self, offset: usize) -> Result<T, ReadError>

pub fn read_with_args<T>( &self, range: Range<usize>, args: &T::Args ) -> Result<T, ReadError>where T: FontReadWithArgs<'a>,

pub unsafe fn read_at_unchecked<T: ReadScalar>(&self, offset: usize) -> T

Read a scalar value out of the buffer at offset, elliding bounds checks

Safety

The range offset..offset + T::RAW_BYTE_LEN must be in bounds.

pub fn read_ref_at<T: FixedSize>( &self, offset: usize ) -> Result<&'a T, ReadError>

pub fn read_array<T: FixedSize>( &self, range: Range<usize> ) -> Result<&'a [T], ReadError>

pub unsafe fn read_array_unchecked<T: FixedSize>( &self, range: Range<usize> ) -> &'a [T]

Interpret the bytes at offset as a reference to some type T.

Safety

T must be a struct or scalar that has alignment of 1, a non-zero size, and no internal padding, and range must have a length that is non-zero and is a multiple of size_of::<T>().

Trait Implementations

impl AsRef<[u8]> for FontData<'_>

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

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

impl<'a> Clone for FontData<'a>

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

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for FontData<'a>

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

Formats the value using the given formatter.

impl<'a> Default for FontData<'a>

fn default() -> FontData<'a>

Returns the “default value” for a type.

impl<'a> FontRead<'a> for FontData<'a>

fn read(data: FontData<'a>) -> Result<Self, ReadError>

Read an instace of Self from the provided data, performing validation.

impl<'a> From<&'a [u8]> for FontData<'a>

fn from(src: &'a [u8]) -> FontData<'a>

Converts to this type from the input type.

impl<'a> From<FontData<'a>> for Cow<'a, [u8]>

fn from(src: FontData<'a>) -> Self

Converts to this type from the input type.

impl<'a> Copy for FontData<'a>