Struct harfbuzz::Blob

pub struct Blob<'a> { /* fields omitted */ }

Blobs wrap a chunk of binary data to handle lifecycle management of data while it is passed between client and HarfBuzz.

Blobs are primarily used to create font faces, but also to access font face tables, as well as pass around other binary data.

Implementations

impl<'a> Blob<'a>

pub fn new_read_only(data: &'a [u8]) -> Blob<'a>

Create a new read-only blob.

The data is not copied, so it must outlive the Blob.

let data = vec![1; 256];
let blob = Blob::new_read_only(&data);
assert_eq!(blob.len(), 256);
assert!(!blob.is_empty());

pub fn new_from_arc_vec(data: Arc<Vec<u8>>) -> Blob<'static>

Create a blob wrapping an Arc<Vec<u8>>.

This method allows creation of a blob without copying, where the data may be shared by Rust code and the blob. The Vec is freed when all references are dropped.

let data = vec![1; 256];
let blob = Blob::new_from_arc_vec(Arc::new(data));
assert_eq!(blob.len(), 256);
assert!(!blob.is_empty());

pub unsafe fn from_raw(raw: *mut hb_blob_t) -> Self

Construct a Blob from a raw pointer. Takes ownership of the blob.

pub fn len(&self) -> usize

Returns the size of the blob in bytes.

pub fn is_empty(&self) -> bool

Returns true if the length is zero.

pub fn make_immutable(&mut self)

Make this blob immutable.

pub fn is_immutable(&self) -> bool

Returns true if the blob is immutable.

pub fn as_raw(&self) -> *mut hb_blob_t

Borrows a raw pointer to the blob.

pub fn into_raw(self) -> *mut hb_blob_t

Gives up ownership and returns a raw pointer to the blob.

Trait Implementations

impl<'a> Deref for Blob<'a>

type Target = [u8]

The resulting type after dereferencing.

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

Dereferences the value.

impl<'a> DerefMut for Blob<'a>

fn deref_mut(&mut self) -> &mut [u8]

Mutably dereferences the value.

impl<'a> Drop for Blob<'a>

fn drop(&mut self)

Decrement the reference count, and destroy the blob if the reference count is zero.