Struct cacao::foundation::NSData

source · [−]

pub struct NSData(pub Id<Object>);

Expand description

Wrapper for a retained NSData object.

Supports constructing a new NSData from a Vec<u8>, wrapping and retaining an existing pointer from the Objective-C side, and turning an NSData into a Vec<u8>.

This is an intentionally limited API.

Tuple Fields

0: Id<Object>

Implementations

source

impl NSData

source

pub fn new(bytes: Vec<u8>) -> Self

Given a vector of bytes, creates, retains, and returns a wrapped NSData.

This method is borrowed straight out of objc-foundation by the amazing Steven Sheldon, and just tweaked slightly to fit the desired API semantics here.

source

pub fn with_slice(bytes: &[u8]) -> Self

Given a slice of bytes, creates, retains, and returns a wrapped NSData.

This method is borrowed straight out of objc-foundation by the amazing Steven Sheldon, and just tweaked slightly to fit the desired API semantics here.

source

pub fn retain(data: id) -> Self

Given a (presumably) NSData, wraps and retains it.

source

pub fn from_retained(data: id) -> Self

If we’re vended an NSData from a method (e.g, a push notification token) we might want to wrap it while we figure out what to do with it. This does that.

source

pub fn is(obj: id) -> bool

A helper method for determining if a given NSObject is an NSData.

source

pub fn len(&self) -> usize

Returns the length of the underlying NSData bytes.

source

pub fn bytes(&self) -> &[u8]ⓘNotable traits for &[u8]`impl Read for &[u8]impl Write for &mut [u8]`

Returns a reference to the underlying bytes for the wrapped NSData.

This, like NSData::new(), is cribbed from objc-foundation.

objc-foundation

source

pub fn into_vec(self) -> Vec<u8>

Creates a new Vec, copies the NSData (safely, but quickly) bytes into that Vec, and consumes the NSData enabling it to release (provided nothing in Cocoa is using it).

Methods from Deref<Target = Object>

source

pub fn class(&self) -> &Class

Returns the class of self.

source

pub unsafe fn get_ivar<T>(&self, name: &str) -> &T where
T: Encode,

Returns a reference to the ivar of self with the given name. Panics if self has no ivar with the given name. Unsafe because the caller must ensure that the ivar is actually of type T.

source

pub unsafe fn get_mut_ivar<T>(&mut self, name: &str) -> &mut T where
T: Encode,

Returns a mutable reference to the ivar of self with the given name. Panics if self has no ivar with the given name. Unsafe because the caller must ensure that the ivar is actually of type T.

source

pub unsafe fn set_ivar<T>(&mut self, name: &str, value: T) where
T: Encode,

Sets the value of the ivar of self with the given name. Panics if self has no ivar with the given name. Unsafe because the caller must ensure that the ivar is actually of type T.