Struct mynewt::Strn

[+] Show declaration

pub struct Strn {
    pub rep: StrnRep,
}

[−] Expand description

Represents a null-terminated string, suitable for passing to Mynewt APIs as * const char. The string could be a null-terminated byte string created in Rust, or a pointer to a null-terminated string returned by C. Pointer may be null.

Fields

rep: StrnRep

[−] Expand description

Either a byte string terminated with null, or a pointer to a null-terminated string

Methods

impl Strn[−]

pub fn new(bs: &'static [u8]) -> Strn[−]

Create a new Strn with a byte string. Fail if the last byte is not zero.

Strn::new(b"network\0")
strn!("network")

pub fn from_cstr(cstr: *const u8) -> Strn[−]

Create a new Strn with a null-terminated string pointer returned by C.

pub fn as_ptr(&self) -> *const u8[−]

Return a pointer to the string

pub fn len(&self) -> usize[−]

Return the length of the string. TODO: For safety, we limit to 128.

pub fn as_cstr(&self) -> *const u8[−]

Return the byte string as a null-terminated * const char C-style string. Fail if the last byte is not zero.

pub fn as_bytestr(&self) -> &'static [u8][−]

Return the byte string. Fail if the last byte is not zero.

pub fn validate(&self)[−]

Fail if the last byte is not zero.

pub fn validate_bytestr(bs: &'static [u8])[−]

Fail if the last byte is not zero.

Trait Implementations

impl Send for Strn

Allow threads to share Strn, since it is static.

impl Sync for Strn

Allow threads to share Strn, since it is static.