CFData

Struct CFData 

Source
pub struct CFData { /* private fields */ }
Available on crate feature CFData only.
Expand description

Apple’s documentation

This is toll-free bridged with NSData.

Implementations§

Source§

impl CFData

Source

pub fn from_bytes(bytes: &[u8]) -> CFRetained<Self>

Creates a new CFData from a byte slice.

Source

pub fn from_buffer(bytes: &[u8]) -> CFRetained<Self>

👎Deprecated: renamed to CFData::from_bytes

Alias for easier transition from the core-foundation crate.

Source

pub fn from_static_bytes(bytes: &'static [u8]) -> CFRetained<Self>

Creates a new CFData from a 'static byte slice.

This may be slightly more efficient than CFData::from_bytes, as it may be able to re-use the existing buffer (since we know it won’t be deallocated).

Source

pub fn len(&self) -> usize

The number of bytes contained by the CFData.

Source

pub fn is_empty(&self) -> bool

Whether the CFData is empty.

Source

pub unsafe fn as_bytes_unchecked(&self) -> &[u8]

The underlying bytes in the CFData.

§Safety

The CFData must not be mutated for the lifetime of the returned string. Consider using to_vec instead if this requirement is a bit difficult to uphold.

Source

pub fn to_vec(&self) -> Vec<u8>

Available on crate feature alloc only.

Copy the contents of the CFData into a new Vec.

Source§

impl CFData

Source

pub unsafe fn new( allocator: Option<&CFAllocator>, bytes: *const u8, length: CFIndex, ) -> Option<CFRetained<CFData>>

§Safety
  • allocator might not allow None.
  • bytes must be a valid pointer.
Source

pub unsafe fn with_bytes_no_copy( allocator: Option<&CFAllocator>, bytes: *const u8, length: CFIndex, bytes_deallocator: Option<&CFAllocator>, ) -> Option<CFRetained<CFData>>

§Safety
  • allocator might not allow None.
  • bytes must be a valid pointer.
  • bytes_deallocator might not allow None.
Source

pub fn new_copy( allocator: Option<&CFAllocator>, the_data: Option<&CFData>, ) -> Option<CFRetained<CFData>>

Source§

impl CFData

Source

pub fn length(&self) -> CFIndex

Source

pub fn byte_ptr(&self) -> *const u8

Source§

impl CFData

Source

pub unsafe fn bytes(&self, range: CFRange, buffer: *mut u8)

§Safety

buffer must be a valid pointer.

Source§

impl CFData

Source

pub unsafe fn find( &self, data_to_find: Option<&CFData>, search_range: CFRange, compare_options: CFDataSearchFlags, ) -> CFRange

§Safety

data_to_find might not allow None.

Methods from Deref<Target = CFType>§

Source

pub fn downcast_ref<T: ConcreteType>(&self) -> Option<&T>

Attempt to downcast the type to that of type T.

This is the reference-variant. Use CFRetained::downcast if you want to convert a retained type. See also ConcreteType for more details on which types support being converted to.

Source

pub fn retain_count(&self) -> usize

Get the reference count of the object.

This function may be useful for debugging. You normally do not use this function otherwise.

Beware that some things (like CFNumbers, small CFStrings etc.) may not have a normal retain count for optimization purposes, and can return usize::MAX in that case.

Trait Implementations§

Source§

impl AsRef<AnyObject> for CFData

Source§

fn as_ref(&self) -> &AnyObject

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

impl AsRef<CFData> for CFData

Source§

fn as_ref(&self) -> &Self

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

impl AsRef<CFData> for CFMutableData

Source§

fn as_ref(&self) -> &CFData

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

impl AsRef<CFType> for CFData

Source§

fn as_ref(&self) -> &CFType

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

impl Borrow<AnyObject> for CFData

Source§

fn borrow(&self) -> &AnyObject

Immutably borrows from an owned value. Read more
Source§

impl Borrow<CFData> for CFMutableData

Source§

fn borrow(&self) -> &CFData

Immutably borrows from an owned value. Read more
Source§

impl Borrow<CFType> for CFData

Source§

fn borrow(&self) -> &CFType

Immutably borrows from an owned value. Read more
Source§

impl ConcreteType for CFData

Source§

fn type_id() -> CFTypeID

Get the unique CFTypeID identifier for the type. Read more
Source§

impl Debug for CFData

Source§

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

Formats the value using the given formatter. Read more
Source§

impl Deref for CFData

Source§

type Target = CFType

The resulting type after dereferencing.
Source§

fn deref(&self) -> &Self::Target

Dereferences the value.
Source§

impl Hash for CFData

Source§

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

Feeds this value into the given Hasher. Read more
1.3.0 · Source§

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

Feeds a slice of this type into the given Hasher. Read more
Source§

impl Message for CFData

Source§

fn retain(&self) -> Retained<Self>
where Self: Sized,

Increment the reference count of the receiver. Read more
Source§

impl PartialEq for CFData

Source§

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

Tests for self and other values to be equal, and is used by ==.
1.0.0 · Source§

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

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

impl RefEncode for CFData

Source§

const ENCODING_REF: Encoding

The Objective-C type-encoding for a reference of this type. Read more
Source§

impl Type for CFData

Source§

fn retain(&self) -> CFRetained<Self>
where Self: Sized,

Increment the reference count of the receiver. Read more
Source§

fn as_concrete_TypeRef(&self) -> &Self

👎Deprecated: this is redundant
Helper for easier transition from the core-foundation crate.
Source§

unsafe fn wrap_under_get_rule(ptr: *const Self) -> CFRetained<Self>
where Self: Sized,

👎Deprecated: use CFRetained::retain
Helper for easier transition from the core-foundation crate. Read more
Source§

fn as_CFTypeRef(&self) -> &CFType
where Self: AsRef<CFType>,

👎Deprecated: this is redundant (CF types deref to CFType)
Helper for easier transition from the core-foundation crate.
Source§

unsafe fn wrap_under_create_rule(ptr: *const Self) -> CFRetained<Self>
where Self: Sized,

👎Deprecated: use CFRetained::from_raw
Helper for easier transition from the core-foundation crate. Read more
Source§

impl Eq for CFData

Auto Trait Implementations§

§

impl !Freeze for CFData

§

impl !RefUnwindSafe for CFData

§

impl !Send for CFData

§

impl !Sync for CFData

§

impl !Unpin for CFData

§

impl !UnwindSafe for CFData

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<P, T> Receiver for P
where P: Deref<Target = T> + ?Sized, T: ?Sized,

Source§

type Target = T

🔬This is a nightly-only experimental API. (arbitrary_self_types)
The target type on which the method may be called.
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.
Source§

impl<T> AutoreleaseSafe for T
where T: ?Sized,