IntoIdent

Struct IntoIdent 

Source
pub struct IntoIdent<T>(/* private fields */);
Expand description

Parses T and concats all its elements to a single identifier by removing all characters that are not valid in identifiers. When T implements Default, such as single string (non group) keywords, operators and Const* literals. Then it can be used to create IntoIdentifier on the fly. Note that construction may still fail when one tries to create a invalid identifier such as one starting with digits for example.

§Example

let mut token_iter = "foo 123".to_token_iter();

let parsed = <IntoIdent<Cons<Ident, LiteralInteger>>>::parser(&mut token_iter).unwrap();
assert_tokens_eq!(parsed, "foo123");

keyword!{Foo = "foo"}
let default = <IntoIdent<Cons<Foo, ConstInteger<1234>>>>::default();
assert_tokens_eq!(default, "foo1234");

Implementations§

Source§

impl<T> IntoIdent<T>
where T: ToTokens,

Source

pub fn from(from: &T) -> Result<IntoIdent<T>, Error>

Creates a IntoIdent from an AST.

§Errors

This function returns an error when the provided data cannot be parsed as an identifier.

let mut token_iter = r#" foo "123" "#.to_token_iter();

let parsed = <Cons<Ident, LiteralString>>::parser(&mut token_iter).unwrap();
let ident = IntoIdent::from(&parsed).unwrap();

assert_eq!(ident.as_str(), "foo123");
Source§

impl<T> IntoIdent<T>

Source

pub fn as_str(&self) -> &str

Returns the underlying &strwithout its surrounding quotes.

Source

pub fn into_inner(self) -> Cached<Ident>

Destructures IntoIdent<T> to get the inner CachedIdent.

Trait Implementations§

Source§

impl<T> Debug for IntoIdent<T>
where T: Debug,

Source§

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

Formats the value using the given formatter. Read more
Source§

impl<T> Default for IntoIdent<T>
where T: Default + ToTokens,

Available on crate feature proc_macro2 only.

Creates a default constructed IntoIdent<T> from T

§Panics

When the concatenation of T does not form a valid Ident.

Source§

fn default() -> IntoIdent<T>

Returns the “default value” for a type. Read more
Source§

impl<T> From<IntoIdent<T>> for Ident

Available on crate feature proc_macro2 only.

Converts IntoIdent<T> into Ident by consuming the IntoIdent<T>.

Source§

fn from(this: IntoIdent<T>) -> Ident

Converts to this type from the input type.
Source§

impl<T> Parser for IntoIdent<T>
where T: Parse + ToTokens,

Available on crate feature proc_macro2 only.
Source§

fn parser(tokens: &mut TokenIter) -> Result<IntoIdent<T>, Error>

The actual parsing function that must be implemented. This mutates the tokens iterator directly. It should not be called from user code except for implementing parsers itself and then only when the rules below are followed. Read more
Source§

impl<T> ToTokens for IntoIdent<T>
where T: ToTokens,

Available on crate feature proc_macro2 only.
Source§

fn to_tokens(&self, tokens: &mut TokenStream)

Write &self to the given TokenStream. Read more
Source§

fn to_token_iter(&self) -> TokenIter

Convert &self into a TokenIter object.
Source§

fn into_token_iter(self) -> TokenIter
where Self: Sized,

Convert self into a TokenIter object.
Source§

fn to_token_stream(&self) -> TokenStream

Convert &self into a TokenStream object.
Source§

fn into_token_stream(self) -> TokenStream
where Self: Sized,

Convert self into a TokenStream object.
Source§

fn tokens_to_string(&self) -> String

Convert &self into a String object. This is mostly used in the test suite to compare the outputs. When the input is a &str then this parses it and returns a normalized String.

Auto Trait Implementations§

§

impl<T> Freeze for IntoIdent<T>

§

impl<T> RefUnwindSafe for IntoIdent<T>
where T: RefUnwindSafe,

§

impl<T> !Send for IntoIdent<T>

§

impl<T> !Sync for IntoIdent<T>

§

impl<T> Unpin for IntoIdent<T>
where T: Unpin,

§

impl<T> UnwindSafe for IntoIdent<T>
where T: UnwindSafe,

Blanket Implementations§

Source§

impl<T> Any for T
where T: 'static + ?Sized,

Source§

fn type_id(&self) -> TypeId

Gets the TypeId of self. Read more
Source§

impl<T> Borrow<T> for T
where T: ?Sized,

Source§

fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
Source§

impl<T> BorrowMut<T> for T
where T: ?Sized,

Source§

fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
Source§

impl<T> DynamicTokens for T
where T: Any + ToTokens + Debug,

Source§

fn as_any(&self) -> &(dyn Any + 'static)

Upcasts &DynamicTokens to &dyn Any. This allows us to stay backward compatible with older rust. Rust 1.86 implements upcast coercion.
Source§

impl<T> From<T> for T

Source§

fn from(t: T) -> T

Returns the argument unchanged.

Source§

impl<T, U> Into<U> for T
where U: From<T>,

Source§

fn into(self) -> U

Calls U::from(self).

That is, this conversion is whatever the implementation of From<T> for U chooses to do.

Source§

impl<T> Parse for T
where T: Parser,

Source§

fn parse(tokens: &mut TokenIter) -> Result<Self, Error>

This is the user facing API to parse grammatical entities. Calls a parser() within a transaction. Commits changes on success and returns the parsed value. Read more
Source§

fn parse_all(tokens: &mut TokenIter) -> Result<Self, Error>

Exhaustive parsing within a transaction. This is a convenience method that implies a EndOfStream at the end. Thus it will error if parsing is not exhaustive. Read more
Source§

fn parse_with<T>( tokens: &mut TokenIter, f: impl FnOnce(Self, &mut TokenIter) -> Result<T, Error>, ) -> Result<T, Error>

Parse a value in a transaction, pass it to a FnOnce(Self, &mut TokenIter) -> Result<T> closure which creates a new result or returns an Error. Read more
Source§

impl<T, U> TryFrom<U> for T
where U: Into<T>,

Source§

type Error = Infallible

The type returned in the event of a conversion error.
Source§

fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
Source§

impl<T, U> TryInto<U> for T
where U: TryFrom<T>,

Source§

type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
Source§

fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.