Struct SpIBinder

pub struct SpIBinder(/* private fields */);

A strong reference to a Binder remote object.

This struct encapsulates the generic C++ sp<IBinder> class. This wrapper is untyped; typed interface access is implemented by the AIDL compiler.

Implementations

impl SpIBinder

pub unsafe fn as_raw(&self) -> *mut AIBinder

Extract a raw AIBinder pointer from this wrapper.

This method should only be used for testing. Do not try to use the NDK interface directly for anything else.

Safety

The resulting pointer is valid only as long as the SpIBinder is alive. The SpIBinder object retains ownership of the AIBinder and the caller should not attempt to free the returned pointer.

pub fn is_remote(&self) -> bool

Return true if this binder object is hosted in a different process than the current one.

pub fn into_interface<I: FromIBinder + Interface + ?Sized>( self, ) -> Result<Strong<I>, StatusCode>

Try to convert this Binder object into a trait object for the given Binder interface.

If this object does not implement the expected interface, the error StatusCode::BAD_TYPE is returned.

pub fn get_class(&mut self) -> Option<InterfaceClass>

Return the interface class of this binder object, if associated with one.

pub fn downgrade(&mut self) -> WpIBinder

Creates a new weak reference to this binder object.

Trait Implementations

impl AssociateClass for SpIBinder

fn associate_class(&mut self, class: InterfaceClass) -> bool

Check if this object is a valid object for the given interface class I.

impl Clone for SpIBinder

fn clone(&self) -> Self

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for SpIBinder

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

Formats the value using the given formatter.

impl Deserialize for SpIBinder

type UninitType = Option<SpIBinder>

Type for the uninitialized value of this type. Will be either Self if the type implements Default, Option<Self> otherwise.

fn uninit() -> Self::UninitType

Return an uninitialized or default-initialized value for this type.

fn from_init(value: Self) -> Self::UninitType

Convert an initialized value of type Self into Self::UninitType.

fn deserialize(parcel: &BorrowedParcel<'_>) -> Result<SpIBinder, StatusCode>

Deserialize an instance from the given crate::parcel::Parcel.

const ASSERT_UNINIT_SIZE_AND_ALIGNMENT: bool = _

Assert at compile-time that Self and Self::UninitType have the same size and alignment. This will either fail to compile or evaluate to true. The only two macros that work here are panic! and assert!, so we cannot use assert_eq!.

fn deserialize_from( &mut self, parcel: &BorrowedParcel<'_>, ) -> Result<(), StatusCode>

Deserialize an instance from the given crate::parcel::Parcel onto the current object. This operation will overwrite the old value partially or completely, depending on how much data is available.

impl DeserializeArray for SpIBinder

fn deserialize_array( parcel: &BorrowedParcel<'_>, ) -> Result<Option<Vec<Self>>, StatusCode>

Deserialize an array of type from the given parcel.

impl DeserializeOption for SpIBinder

fn deserialize_option( parcel: &BorrowedParcel<'_>, ) -> Result<Option<SpIBinder>, StatusCode>

Deserialize an Option of this type from the given parcel.

fn deserialize_option_from( this: &mut Option<Self>, parcel: &BorrowedParcel<'_>, ) -> Result<(), StatusCode>

Deserialize an Option of this type from the given parcel onto the current object. This operation will overwrite the current value partially or completely, depending on how much data is available.

impl Drop for SpIBinder

fn drop(&mut self)

Executes the destructor for this type.

impl Ord for SpIBinder

fn cmp(&self, other: &Self) -> Ordering

This method returns an Ordering between self and other.

fn max(self, other: Self) -> Self

where Self: Sized,

Compares and returns the maximum of two values.

fn min(self, other: Self) -> Self

where Self: Sized,

Compares and returns the minimum of two values.

fn clamp(self, min: Self, max: Self) -> Self

where Self: Sized,

Restrict a value to a certain interval.

impl PartialEq for SpIBinder

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

Tests for self and other values to be equal, and is used by ==.

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

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

impl PartialOrd for SpIBinder

fn partial_cmp(&self, other: &Self) -> Option<Ordering>

This method returns an ordering between self and other values if one exists.

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

Tests less than (for self and other) and is used by the < operator.

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

Tests less than or equal to (for self and other) and is used by the <= operator.

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

Tests greater than (for self and other) and is used by the > operator.

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

Tests greater than or equal to (for self and other) and is used by the >= operator.

impl Serialize for SpIBinder

fn serialize(&self, parcel: &mut BorrowedParcel<'_>) -> Result<(), StatusCode>

Serialize this instance into the given crate::parcel::Parcel.

impl SerializeArray for SpIBinder

fn serialize_array( slice: &[Self], parcel: &mut BorrowedParcel<'_>, ) -> Result<(), StatusCode>

Serialize an array of this type into the given parcel.

impl SerializeOption for SpIBinder

fn serialize_option( this: Option<&Self>, parcel: &mut BorrowedParcel<'_>, ) -> Result<(), StatusCode>

Serialize an Option of this type into the given parcel.

impl<B: Remotable> TryFrom<SpIBinder> for Binder<B>

type Error = android_c_interface_StatusCode

The type returned in the event of a conversion error.

fn try_from(ibinder: SpIBinder) -> Result<Self, StatusCode>

Performs the conversion.

impl Eq for SpIBinder

impl Send for SpIBinder

Safety: An SpIBinder is an immutable handle to a C++ IBinder, which is thread-safe.

impl Sync for SpIBinder

Safety: An SpIBinder is an immutable handle to a C++ IBinder, which is thread-safe.