impl LitStr

fn new(value: &str, span: Span) -> Self

fn value(&self) -> String

fn parse<T: Parse>(&self) -> Result<T>

Parse a syntax tree node from the content of this string literal.

All spans in the syntax tree will point to the span of this LitStr.

Example

use syn::{Attribute, Error, Expr, Lit, Meta, Path, Result};

// Parses the path from an attribute that looks like:
//
//     #[path = "a::b::c"]
//
// or returns `None` if the input is some other attribute.
fn get_path(attr: &Attribute) -> Result<Option<Path>> {
    if !attr.path().is_ident("path") {
        return Ok(None);
    }

    if let Meta::NameValue(meta) = &attr.meta {
        if let Expr::Lit(expr) = &meta.value {
            if let Lit::Str(lit_str) = &expr.lit {
                return lit_str.parse().map(Some);
            }
        }
    }

    let message = "expected #[path = \"...\"]";
    Err(Error::new_spanned(attr, message))
}

fn parse_with<F: Parser>(&self, parser: F) -> Result<F::Output>

Invoke parser on the content of this string literal.

All spans in the syntax tree will point to the span of this LitStr.

Example

# use proc_macro2::Span;
# use syn::{LitStr, Result};
#
# fn main() -> Result<()> {
#     let lit_str = LitStr::new("a::b::c", Span::call_site());
#
#     const IGNORE: &str = stringify! {
let lit_str: LitStr = /* ... */;
#     };

// Parse a string literal like "a::b::c" into a Path, not allowing
// generic arguments on any of the path segments.
let basic_path = lit_str.parse_with(syn::Path::parse_mod_style)?;
#
#     Ok(())
# }

fn span(&self) -> Span

fn set_span(&mut self, span: Span)

fn suffix(&self) -> &str

fn token(&self) -> Literal