Trait StringLike

pub trait StringLike: ToOwned {
    const NAME: &'static str;

    // Required methods
    fn new_unchecked(_: &str) -> &Self;
    fn new_unchecked_owned(_: String) -> <Self as ToOwned>::Owned;
    fn is_valid(_: &str) -> Result<(), InvalidStringError>;

    // Provided methods
    fn new(s: &str) -> Result<&Self, InvalidStringError> { ... }
    fn new_owned<S: Into<String>>(
        s: S,
    ) -> Result<<Self as ToOwned>::Owned, InvalidStringError> { ... }
}

A D-Bus string-like type - a basic (non-container) type with variable length.

It wraps a str, which means that it is unsized.

Required Associated Constants

const NAME: &'static str

The name of the type

Required Methods

fn new_unchecked(_: &str) -> &Self

Creates a new borrowed string without actually checking that it is valid.

Sending this over D-Bus if actually invalid, could result in e g immediate disconnection from the server.

fn new_unchecked_owned(_: String) -> <Self as ToOwned>::Owned

Creates a new owned string without actually checking that it is valid.

Sending this over D-Bus if actually invalid, could result in e g immediate disconnection from the server.

fn is_valid(_: &str) -> Result<(), InvalidStringError>

Checks whether or not a string is valid.

Provided Methods

fn new(s: &str) -> Result<&Self, InvalidStringError>

Creates a new borrowed string

fn new_owned<S: Into<String>>( s: S, ) -> Result<<Self as ToOwned>::Owned, InvalidStringError>

Creates a new owned string

Dyn Compatibility

This trait is not dyn compatible.

In older versions of Rust, dyn compatibility was called "object safety", so this trait is not object safe.

Implementors

impl StringLike for BusName

const NAME: &'static str = "BusName"

impl StringLike for DBusStr

const NAME: &'static str = "DBusStr"

impl StringLike for ErrorName

const NAME: &'static str = "ErrorName"

impl StringLike for InterfaceName

const NAME: &'static str = "InterfaceName"

impl StringLike for MemberName

const NAME: &'static str = "MemberName"

impl StringLike for ObjectPath

const NAME: &'static str = "ObjectPath"

impl StringLike for SignatureMulti

const NAME: &'static str = "SignatureMulti"

impl StringLike for SignatureSingle

const NAME: &'static str = "SignatureSingle"