Trait Str

pub unsafe trait Str {
    const CONTAINS_NUL: bool;

    // Required methods
    unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self;
    fn as_bytes(&self) -> &[u8] ;
}

Represents str-like types that could be cast to valid byte patterns and back.

Safety

It is the implementor’s responsibility to ensure that the bytes returned by as_bytes could be safely passed to from_bytes_unchecked.

Required Associated Constants

const CONTAINS_NUL: bool

Indicates whether the bytes returned by as_bytes contain a NUL byte.

Required Methods

unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

Casts the given bytes to a reference to Self.

Safety

The bytes must be valid byte patterns for Self.

fn as_bytes(&self) -> &[u8]

Casts the given reference to Self to a slice of bytes.

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.

Implementations on Foreign Types

impl Str for str

const CONTAINS_NUL: bool = false

unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

fn as_bytes(&self) -> &[u8]

impl Str for CStr

const CONTAINS_NUL: bool = true

unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

fn as_bytes(&self) -> &[u8]

impl Str for OsStr

const CONTAINS_NUL: bool = false

unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

fn as_bytes(&self) -> &[u8]

impl Str for Path

const CONTAINS_NUL: bool = false

unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

fn as_bytes(&self) -> &[u8]

impl Str for [u8]

const CONTAINS_NUL: bool = false

unsafe fn from_bytes_unchecked(bytes: &[u8]) -> &Self

fn as_bytes(&self) -> &[u8]

Implementors