Struct NullString

pub struct NullString { /* private fields */ }

A wrapper for a 'static null-terminated string.

Sometimes used in favor of CStr or CString, as NullStrings can be made as compile-time constants.

Implementations

impl NullString

pub const fn new(s: &'static str) -> NullString

Creates a NullString from s or panics if s is not null-terminated.

Panics

Panics if the string s does not end in the null character.

pub const fn as_ptr(self) -> *const c_char

Returns a pointer to the beginning of the wrapped string.

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

Returns a &CStr pointing to the wrapped string.

Trait Implementations

impl AsRef<CStr> for NullString

fn as_ref(&self) -> &CStr

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

impl Clone for NullString

fn clone(&self) -> NullString

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for NullString

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

Formats the value using the given formatter.

impl From<&'static CStr> for NullString

fn from(cstr: &'static CStr) -> Self

Converts to this type from the input type.

impl From<NullString> for &'static CStr

fn from(nstr: NullString) -> Self

Converts to this type from the input type.

impl PrintfArgument for NullString

const IS_C_STRING: bool = true

Whether the type is a null-terminated string.

type CPrintfType = *const i8

The C type corresponding to Self that we should really send as an argument to a printf(3)-like function.

fn as_c_val(self) -> *const c_char

Converts self to a value suitable for sending to printf(3).

const IS_CHAR: bool = false

Whether the type is consistent with C’s char.

const IS_SHORT: bool = false

Whether the type is consistent with C’s short int.

const IS_INT: bool = false

Whether the type is consistent with C’s int.

const IS_LONG: bool = false

Whether the type is consistent with C’s long int.

const IS_LONG_LONG: bool = false

Whether the type is consistent with C’s long long int.

const IS_SIZE: bool = false

Available on crate feature libc only.

Whether the type is consistent with C’s size_t.

const IS_MAX: bool = false

Available on crate feature libc only.

Whether the type is consistent with C’s intmax_t.

const IS_PTRDIFF: bool = false

Available on crate feature libc only.

Whether the type is consistent with C’s ptrdiff_t.

const IS_SIGNED: bool = false

Whether the type is a signed integer type, as opposed to unsigned.

const IS_FLOAT: bool = false

Whether the type is floating-point.

const IS_POINTER: bool = false

Whether the type is a pointer.

impl Copy for NullString

impl Send for NullString

impl Sync for NullString