Struct CRStr 

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

A static string which is jointly usable as a CStr and str.

Implementations

impl CRStr

pub const fn new(data: &'static str) -> Result<Self, CRStrError>

Validate that an input UTF-8 string is null-terminated, and attempt to construct references to each kind of string.

To use, an input string must be null-terminated:

let my_crstr = CRStr::new("some text\0").unwrap();

let str: &str = my_crstr.as_ref();
let cstr: &CStr = my_crstr.as_ref();
assert_eq!(str, "some text");
assert_eq!(cstr, c"some text");

let will_fail = CRStr::new("not null-terminated");
assert!(will_fail.is_err());

pub const fn new_unchecked(data: &'static str) -> Self

CRStr::new which panics on an invalid input. Intended for static/const definitions.

static MY_STR: CRStr = CRStr::new_unchecked("some text\0");

let str: &str = MY_STR.as_ref();
let cstr: &CStr = MY_STR.as_ref();
assert_eq!(str, "some text");
assert_eq!(cstr, c"some text");

pub fn as_str(&self) -> &'static str

Use this string as a str.

pub fn as_cstr(&self) -> &'static CStr

Use this string as a CStr.

Trait Implementations

impl AsRef<CStr> for CRStr

fn as_ref(&self) -> &'static CStr

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

impl AsRef<str> for CRStr

fn as_ref(&self) -> &'static str

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

impl Clone for CRStr

fn clone(&self) -> CRStr

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for CRStr

impl Debug for CRStr

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

Formats the value using the given formatter.

impl Display for CRStr

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

Formats the value using the given formatter.

impl Eq for CRStr

impl Error for CRStr

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

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

Provides type-based access to context intended for error reports.

impl Hash for CRStr

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, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for CRStr

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

Equality operator ==.

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

Inequality operator !=.

impl StructuralPartialEq for CRStr