Struct ObjectRefOwned 

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

A wrapper around the static variant of ObjectRef. This is guaranteed to have a 'static lifetime.

Implementations

impl ObjectRefOwned

pub const fn new(object_ref: ObjectRef<'static>) -> Self

Create a new ObjectRefOwned from an ObjectRef<'static>.

pub const fn from_static_str_unchecked( name: &'static str, path: &'static str, ) -> Self

Create a new ObjectRefOwned from &'static str unchecked.

Safety

The caller must ensure that the strings are valid.

pub fn is_null(&self) -> bool

Returns true if the object reference is Null, otherwise returns false.

pub fn into_inner(self) -> ObjectRef<'static>

Returns the inner ObjectRef, consuming self.

pub fn name(&self) -> Option<&UniqueName<'static>>

Returns the name of the object reference. If the object reference is Null, it returns None. If the object reference is Owned or Borrowed, it returns the name.

Example

use zbus::names::UniqueName;
use zbus::zvariant::ObjectPath;
use atspi_common::ObjectRef;

let name = UniqueName::from_static_str_unchecked(":1.23");
let path = ObjectPath::from_static_str_unchecked("/org/a11y/example/path/007");
let object_ref = ObjectRef::new_borrowed(name, path);

// Check the name of the object reference
assert!(object_ref.name().is_some());
assert_eq!(object_ref.name_as_str().unwrap(), ":1.23");

pub fn path(&self) -> &ObjectPath<'static>

Returns the path of the object reference.
If the object reference is Null, it returns the null-path.

Example

use zbus::names::UniqueName;
use zbus::zvariant::ObjectPath;
use atspi_common::ObjectRef;

let name = UniqueName::from_static_str_unchecked(":1.23");
let path = ObjectPath::from_static_str_unchecked("/org/a11y/example/path/007");
let object_ref = ObjectRef::new_borrowed(name, path);

assert_eq!(object_ref.path_as_str(), "/org/a11y/example/path/007");

pub fn name_as_str(&self) -> Option<&str>

Returns the name of the object reference as a string slice.

pub fn path_as_str(&self) -> &str

Returns the path of the object reference as a string slice.

Trait Implementations

impl Clone for ObjectRefOwned

fn clone(&self) -> ObjectRefOwned

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ObjectRefOwned

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

Formats the value using the given formatter.

impl Default for ObjectRefOwned

fn default() -> ObjectRefOwned

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ObjectRefOwned

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

ObjectRefOwned is deserialized as “Owned” variant ObjectRef<'static>.

impl From<ObjectRef<'_>> for ObjectRefOwned

fn from(object_ref: ObjectRef<'_>) -> Self

Convert an ObjectRef<'_> into an ObjectRefOwned.

Extending lifetime ‘magic’ (from ’o -> ‘static’)

ObjectRef<'_> leans on the implementation of UniqueName and ObjectPath to convert the inner types to 'static. These types have an Inner enum that can contain an Owned, Borrowed, or Static Str type. The Strtype is either a &'static str (static), &str (borrowed), or an Arc<str> (owned).

impl From<ObjectRefOwned> for Structure<'_>

fn from(obj: ObjectRefOwned) -> Self

Converts to this type from the input type.

impl Hash for ObjectRefOwned

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

Feeds this value into the given Hasher.

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

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl<'a> MessageConversionExt<'a, ObjectRefOwned> for RemoveAccessibleEvent

fn try_from_message(msg: &Message, hdr: &Header<'_>) -> Result<Self, AtspiError>

Convert a zbus::Message into this event type. Does all the validation for you.

fn validate_interface(header: &Header<'_>) -> Result<(), AtspiError>

Validate the interface string via zbus::message::Header::interface against Self’s assignment of DBusInterface::DBUS_INTERFACE

fn validate_member(hdr: &Header<'_>) -> Result<(), AtspiError>

Validate the member string via zbus::message::Header::member against Self’s assignment of DBusMember::DBUS_MEMBER

fn validate_body(msg: &Message) -> Result<(), AtspiError>

Validate the body signature against the zvariant::Signature of MessageConversion::Body

impl PartialEq<ObjectRef<'_>> for ObjectRefOwned

fn eq(&self, other: &ObjectRef<'_>) -> 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 PartialEq<ObjectRefOwned> for ObjectRef<'_>

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

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 Serialize for ObjectRefOwned

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

ObjectRefOwned is serialized as the inner ObjectRef.

impl<'m> TryFrom<&'m Header<'_>> for ObjectRefOwned

fn try_from(header: &'m Header<'_>) -> Result<Self, Self::Error>

Construct an ObjectRefOwned from a zbus::message::Header.

type Error = AtspiError

The type returned in the event of a conversion error.

impl TryFrom<OwnedValue> for ObjectRefOwned

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: OwnedValue) -> Result<Self, Self::Error>

Performs the conversion.

impl<'v> TryFrom<Value<'v>> for ObjectRefOwned

type Error = Error

The type returned in the event of a conversion error.

fn try_from(value: Value<'v>) -> Result<Self, Self::Error>

Performs the conversion.

impl Type for ObjectRefOwned

const SIGNATURE: &'static Signature = <ObjectRef<'static> as ::zvariant::Type>::SIGNATURE

The signature for the implementing type, in parsed format.

impl Eq for ObjectRefOwned