Struct mynewt::Strn

pub struct Strn {
    pub rep: StrnRep,
}

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

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.