Struct dbus::strings::Interface

pub struct Interface<'a>(_);

A wrapper around a string that is guaranteed to be a valid D-Bus interface name.

Implementations

impl<'m> Interface<'m>

pub fn new<S: Into<Vec<u8>>>(s: S) -> Result<Interface<'m>, String>

Creates a new instance of this struct.

Note: If the no-string-validation feature is activated, this string will not be checked for conformance with the D-Bus specification.

pub fn from_slice(s: &'m [u8]) -> Result<Interface<'m>, String>

Creates a new instance of this struct. If you end it with \0, it can borrow the slice without extra allocation.

Note: If the no-string-validation feature is activated, this string will not be checked for conformance with the D-Bus specification.

pub unsafe fn from_slice_unchecked(s: &'m [u8]) -> Interface<'m>

This function creates a new instance of this struct, without checking. It's up to you to guarantee that s ends with a \0 and is valid.

pub fn as_cstr(&self) -> &CStr

View this struct as a CStr.

pub fn into_static(self) -> Interface<'static>

Makes sure this string does not contain borrows.

pub fn into_cstring(self) -> CString

Converts this struct to a CString.

Trait Implementations

impl<'a> Append for Interface<'a>

fn append_by_ref(&self, i: &mut IterAppend)

Performs the append operation by borrowing self.

fn append(self, ia: &mut IterAppend) where
    Self: Sized, 

Performs the append operation by consuming self.

impl<'a> Arg for Interface<'a>

const ARG_TYPE: ArgType

The corresponding D-Bus argument type code.

fn signature() -> Signature<'static>

The corresponding D-Bus type signature for this type.

impl<'m> AsRef<CStr> for Interface<'m>

fn as_ref(&self) -> &CStr

Performs the conversion.

impl<'a> Clone for Interface<'a>

fn clone(&self) -> Interface<'a>

Returns a copy of the value.

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

Performs copy-assignment from source.

impl<'a> Debug for Interface<'a>

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

Formats the value using the given formatter.

impl<'m> Deref for Interface<'m>

type Target = str

The resulting type after dereferencing.

fn deref(&self) -> &str

Dereferences the value.

impl<'a> DictKey for Interface<'a>

impl<'m> Display for Interface<'m>

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

Formats the value using the given formatter.

impl<'a> Eq for Interface<'a>

impl<'m> From<&'m CStr> for Interface<'m>

#Panics

If given string is not valid.

fn from(s: &'m CStr) -> Interface<'m>

Performs the conversion.

impl<'inner, 'm: 'inner> From<&'m Interface<'inner>> for Interface<'m>

fn from(borrow: &'m Interface<'inner>) -> Interface<'m>

Performs the conversion.

impl<'m> From<&'m String> for Interface<'m>

#Panics

If given string is not valid.

fn from(s: &'m String) -> Interface<'m>

Performs the conversion.

impl<'m> From<&'m str> for Interface<'m>

#Panics

If given string is not valid.

fn from(s: &'m str) -> Interface<'m>

Performs the conversion.

impl<'m> From<Cow<'m, str>> for Interface<'m>

#Panics

If given string is not valid.

fn from(s: Cow<'m, str>) -> Interface<'m>

Performs the conversion.

impl<'m> From<Interface<'m>> for CString

fn from(s: Interface<'m>) -> CString

Performs the conversion.

impl<'m> From<String> for Interface<'m>

#Panics

If given string is not valid.

fn from(s: String) -> Interface<'m>

Performs the conversion.

impl<'a> Get<'a> for Interface<'static>

fn get(i: &mut Iter<'a>) -> Option<Interface<'static>>

Performs the get operation.

impl<'m> Hash for Interface<'m>

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, 

Feeds a slice of this type into the given [Hasher].

impl<'a> Ord for Interface<'a>

fn cmp(&self, other: &Interface<'a>) -> Ordering

This method returns an [Ordering] between self and other.

#[must_use]fn max(self, other: Self) -> Self

Compares and returns the maximum of two values.

#[must_use]fn min(self, other: Self) -> Self

Compares and returns the minimum of two values.

#[must_use]fn clamp(self, min: Self, max: Self) -> Self

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

Restrict a value to a certain interval.

impl<'a> PartialEq<Interface<'a>> for Interface<'a>

fn eq(&self, other: &Interface<'a>) -> bool

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

fn ne(&self, other: &Interface<'a>) -> bool

This method tests for !=.

impl<'a> PartialOrd<Interface<'a>> for Interface<'a>

fn partial_cmp(&self, other: &Interface<'a>) -> Option<Ordering>

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

fn lt(&self, other: &Interface<'a>) -> bool

This method tests less than (for self and other) and is used by the < operator.

fn le(&self, other: &Interface<'a>) -> bool

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

fn gt(&self, other: &Interface<'a>) -> bool

This method tests greater than (for self and other) and is used by the > operator.

fn ge(&self, other: &Interface<'a>) -> bool

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

impl RefArg for Interface<'static>

fn arg_type(&self) -> ArgType

The corresponding D-Bus argument type code.

fn signature(&self) -> Signature<'static>

The corresponding D-Bus type signature for this type.

fn append(&self, i: &mut IterAppend)

Performs the append operation.

fn as_any(&self) -> &dyn Any

Transforms this argument to Any (which can be downcasted to read the current value).

fn as_any_mut(&mut self) -> &mut dyn Any

Transforms this argument to Any (which can be downcasted to read the current value).

fn as_str(&self) -> Option<&str>

Try to read the argument as a str.

fn box_clone(&self) -> Box<dyn RefArg + 'static>

Deep clone of the RefArg, causing the result to be 'static.

fn as_i64(&self) -> Option<i64>

Try to read the argument as an i64.

fn as_u64(&self) -> Option<u64>

Try to read the argument as an u64.

fn as_f64(&self) -> Option<f64>

Try to read the argument as an f64.

fn as_iter<'a>(
    &'a self
) -> Option<Box<dyn Iterator<Item = &'a dyn RefArg> + 'a>>

Try to read the argument as an iterator.

fn as_static_inner(&self, _index: usize) -> Option<&(dyn RefArg + 'static)> where
    Self: 'static, 

Try to read the inner of an argument, as another argument, specifying an index.

impl<'a> StructuralEq for Interface<'a>

impl<'a> StructuralPartialEq for Interface<'a>