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, excluding the terminating null. For safety, we limit to 128.

pub fn is_empty(&self) -> bool

Return true if the string is empty

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 Clone for Strn

fn clone(&self) -> Strn

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Copy for Strn

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.

impl ToBytesOptionalNull for Strn

Convert the type to array of bytes that may or may not end with null. Strn always ends with null.

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

Convert the type to array of bytes that may or may not end with null. Strn always ends with null.