Struct tokio_dbus::ObjectPathBuf

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

A validated owned object path.

The following rules define a valid object path. Implementations must not send or accept messages with invalid object paths.

• The path may be of any length.
• The path must begin with an ASCII ‘/’ (integer 47) character, and must consist of elements separated by slash characters.
• Each element must only contain the ASCII characters “[A-Z][a-z][0-9]_”
• No element may be the empty string.
• Multiple ‘/’ characters cannot occur in sequence.
• A trailing ‘/’ character is not allowed unless the path is the root path (a single ‘/’ character).

Methods from Deref<Target = ObjectPath>

pub const ROOT: &'static Self = _

pub fn iter(&self) -> Iter<'_>

Construct an iterator over the object path.

Examples

use tokio_dbus::ObjectPath;

let mut it = ObjectPath::new_const(b"/").iter();
assert!(it.next().is_none());

let mut it = ObjectPath::new_const(b"/foo").iter();
assert_eq!(it.next(), Some("foo"));
assert!(it.next().is_none());

let mut it = ObjectPath::new_const(b"/foo/bar").iter();
assert_eq!(it.next_back(), Some("bar"));
assert_eq!(it.next(), Some("foo"));
assert!(it.next().is_none());

pub fn starts_with(&self, other: &ObjectPath) -> bool

Test if one part starts with another.

Examples

use tokio_dbus::ObjectPath;

const FOO: &ObjectPath = ObjectPath::new_const(b"/foo");
const FOO_BAR: &ObjectPath = ObjectPath::new_const(b"/foo/bar");

assert!(FOO_BAR.starts_with(FOO));

Trait Implementations

impl AsRef<ObjectPath> for ObjectPathBuf

fn as_ref(&self) -> &ObjectPath

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

impl Borrow<ObjectPath> for ObjectPathBuf

fn borrow(&self) -> &ObjectPath

Immutably borrows from an owned value.

impl Clone for ObjectPathBuf

fn clone(&self) -> ObjectPathBuf

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Deref for ObjectPathBuf

type Target = ObjectPath

The resulting type after dereferencing.

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

Dereferences the value.

impl PartialEq for ObjectPathBuf

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

This method tests for self and other values to be equal, and is used by ==.

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

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

impl Eq for ObjectPathBuf

impl StructuralPartialEq for ObjectPathBuf