Struct Status

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

High-level binder status object that encapsulates a standard way to keep track of and chain binder errors along with service specific errors.

Used in AIDL transactions to represent failed transactions.

Implementations

impl Status

pub fn ok() -> Self

Create a status object representing a successful transaction.

pub fn new_service_specific_error(err: i32, message: Option<&CStr>) -> Status

Create a status object from a service specific error

pub fn new_service_specific_error_str<T: AsRef<str>>( err: i32, message: Option<T>, ) -> Status

Creates a status object from a service specific error.

pub fn new_exception(exception: ExceptionCode, message: Option<&CStr>) -> Status

Create a status object from an exception code

pub fn new_exception_str<T: AsRef<str>>( exception: ExceptionCode, message: Option<T>, ) -> Status

Creates a status object from an exception code and message.

pub fn is_ok(&self) -> bool

Returns true if this status represents a successful transaction.

pub fn get_description(&self) -> String

Returns a description of the status.

pub fn exception_code(&self) -> ExceptionCode

Returns the exception code of the status.

pub fn transaction_error(&self) -> StatusCode

Return a status code representing a transaction failure, or StatusCode::OK if there was no transaction failure.

If this method returns OK, the status may still represent a different exception or a service specific error. To find out if this transaction as a whole is okay, use is_ok instead.

pub fn service_specific_error(&self) -> i32

Return a service specific error if this status represents one.

This function will only ever return a non-zero result if exception_code returns ExceptionCode::SERVICE_SPECIFIC. If this function returns 0, the status object may still represent a different exception or status. To find out if this transaction as a whole is okay, use is_ok instead.

pub fn and_then<T, F>(self, op: F) -> Result<T, Status>

where F: FnOnce() -> Result<T, Status>,

Calls op if the status was ok, otherwise returns an Err value of self.

Trait Implementations

impl Debug for Status

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

Formats the value using the given formatter.

impl Deserialize for Status

type UninitType = Option<Status>

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<Self, 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 Display for Status

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

Formats the value using the given formatter.

impl Drop for Status

fn drop(&mut self)

Executes the destructor for this type.

impl Error for Status

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Status> for Result<(), Status>

fn from(status: Status) -> Result<(), Status>

Converts to this type from the input type.

impl From<Status> for status_t

fn from(status: Status) -> status_t

Converts to this type from the input type.

impl From<android_c_interface_ExceptionCode> for Status

fn from(code: ExceptionCode) -> Status

Converts to this type from the input type.

impl From<android_c_interface_StatusCode> for Status

fn from(status: StatusCode) -> Status

Converts to this type from the input type.

impl From<i32> for Status

fn from(status: status_t) -> Status

Converts to this type from the input type.

impl PartialEq for Status

fn eq(&self, other: &Status) -> 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 Serialize for Status

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

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

impl Eq for Status

impl Send for Status

impl Sync for Status