Struct CStringLit 

pub struct CStringLit<B: Buffer> {
    raw: B,
    value: CString,
    num_hashes: Option<u8>,
    start_suffix: usize,
}

A C string or raw C string literal, e.g. c"hello" or cr#"abc"def"#.

See the reference for more information.

Fields

raw: B

The raw input.

value: CString

The string value (with all escaped unescaped) as CString. This is not an Option as we always have to add the trailing zero byte.

num_hashes: Option<u8>

The number of hash signs in case of a raw string literal, or None if it’s not a raw string literal.

start_suffix: usize

Start index of the suffix or raw.len() if there is no suffix.

Implementations

impl<B: Buffer> CStringLit<B>

pub fn parse(input: B) -> Result<Self, ParseError>

Parses the input as a (raw) byte string literal. Returns an error if the input is invalid or represents a different kind of literal.

pub fn value(&self) -> &CStr

Returns the string value this literal represents (where all escapes have been turned into their respective values).

pub fn into_value(self) -> CString

Like value but returns an owned version of the value.

pub fn suffix(&self) -> &str

The optional suffix. Returns "" if the suffix is empty/does not exist.

pub fn is_raw_c_string(&self) -> bool

Returns whether this literal is a raw string literal (starting with cr).

pub fn raw_input(&self) -> &str

Returns the raw input that was passed to parse.

pub fn into_raw_input(self) -> B

Returns the raw input that was passed to parse, potentially owned.

impl CStringLit<&str>

pub fn into_owned(self) -> CStringLit<String>

Makes a copy of the underlying buffer and returns the owned version of Self.

Trait Implementations

impl<B: Clone + Buffer> Clone for CStringLit<B>

fn clone(&self) -> CStringLit<B>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<B: Debug + Buffer> Debug for CStringLit<B>

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

Formats the value using the given formatter.

impl<B: Buffer> Display for CStringLit<B>

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

Formats the value using the given formatter.

impl<B: Buffer> From<CStringLit<B>> for Literal

fn from(l: CStringLit<B>) -> Self

Converts to this type from the input type.

impl<B: Buffer> From<CStringLit<B>> for Literal<B>

fn from(src: CStringLit<B>) -> Self

Converts to this type from the input type.

impl<B: PartialEq + Buffer> PartialEq for CStringLit<B>

fn eq(&self, other: &CStringLit<B>) -> bool

Tests for self and other values to be equal, and is used by ==.

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

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl TryFrom<&Literal> for CStringLit<String>

type Error = InvalidToken

The type returned in the event of a conversion error.

fn try_from(src: &Literal) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<&TokenTree> for CStringLit<String>

type Error = InvalidToken

The type returned in the event of a conversion error.

fn try_from(tt: &TokenTree) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<Literal> for CStringLit<String>

type Error = InvalidToken

The type returned in the event of a conversion error.

fn try_from(src: Literal) -> Result<Self, Self::Error>

Performs the conversion.

impl TryFrom<TokenTree> for CStringLit<String>

type Error = InvalidToken

The type returned in the event of a conversion error.

fn try_from(tt: TokenTree) -> Result<Self, Self::Error>

Performs the conversion.

impl<B: Eq + Buffer> Eq for CStringLit<B>

impl<B: Buffer> StructuralPartialEq for CStringLit<B>