Trait IntoCStr

pub trait IntoCStr: Sized {
    type Temp: Deref<Target = CStr>;

    // Required methods
    fn into(self) -> Self::Temp;
    fn into_cstring(self) -> CString;
    fn len(&self) -> usize;

    // Provided methods
    fn is_empty(&self) -> bool { ... }
    unsafe fn push_to_non_null_vec(self, bs: &mut Vec<u8>) { ... }
}

Represents any type that can be converted into something that can be deref’ed to a &CStr.

Required Associated Types

type Temp: Deref<Target = CStr>

The type that can actually be converted into a CStr.

Required Methods

fn into(self) -> Self::Temp

Convert this value into a Temp that can be converted into a CStr.

fn into_cstring(self) -> CString

Convert this value directly into a CString.

fn len(&self) -> usize

Length in bytes of the CString within.

Provided Methods

fn is_empty(&self) -> bool

Checks whether the string is empty.

unsafe fn push_to_non_null_vec(self, bs: &mut Vec<u8>)

Adds the bytes of the CStr within to the given Vec.

SAFETY: Unsafe because we will not check there are no NULs. Reimplement this if fn into() does extra allocations.

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 IntoCStr for &str

type Temp = CString

fn into(self) -> Self::Temp

fn into_cstring(self) -> CString

fn len(&self) -> usize

unsafe fn push_to_non_null_vec(self, bs: &mut Vec<u8>)

impl IntoCStr for &String

type Temp = CString

fn into(self) -> Self::Temp

fn into_cstring(self) -> CString

fn len(&self) -> usize

unsafe fn push_to_non_null_vec(self, bs: &mut Vec<u8>)

impl IntoCStr for &CStr

type Temp = &CStr

fn into(self) -> Self

fn into_cstring(self) -> CString

fn len(&self) -> usize

impl IntoCStr for CString

type Temp = CString

fn into(self) -> Self

fn into_cstring(self) -> CString

fn len(&self) -> usize

impl IntoCStr for String

type Temp = CString

fn into(self) -> Self::Temp

fn into_cstring(self) -> CString

fn len(&self) -> usize

impl<'a> IntoCStr for &'a CString

type Temp = &'a CStr

fn into(self) -> &'a CStr

fn into_cstring(self) -> CString

fn len(&self) -> usize

impl<'a, B> IntoCStr for Cow<'a, B>

where B: 'a + ToOwned + ?Sized, &'a B: IntoCStr, B::Owned: IntoCStr, <&'a B as IntoCStr>::Temp: Into<Cow<'a, CStr>>,

type Temp = Cow<'a, CStr>

fn into(self) -> Cow<'a, CStr>

fn into_cstring(self) -> CString

fn len(&self) -> usize

Implementors