DynNode

Struct DynNode 

Source
pub struct DynNode<T = Nothing>(pub Rc<RefCell<Box<dyn DynamicTokens>>>, _);
Expand description

Parses a T (default: Nothing). Allows one to replace it at runtime, after parsing with anything else implementing ToTokens. This is backed by a Rc. One can replace any cloned occurrences or only the current one.

§Example

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

let parsed = <DynNode<Ident>>::parser(&mut token_iter).unwrap();
assert_tokens_eq!(parsed, "foo");

let _test: Ident = parsed.downcast_ref::<Ident>().unwrap().clone();

// Global replacement of all cloned locations (parsed & other)
let mut other = parsed.clone();
other.replace_all_with(<Cons<ConstInteger<123>, Comma>>::default());
assert_tokens_eq!(parsed, "123,");

// Local replacement (only other)
other.replace_here_with(Bang::default());
assert_tokens_eq!(other, "!");
assert_tokens_eq!(parsed, "123,");

Tuple Fields§

§0: Rc<RefCell<Box<dyn DynamicTokens>>>

Implementations§

Source§

impl<T> DynNode<T>

Source

pub fn replace_all_with<U>(&self, this: U) -> Box<dyn DynamicTokens>
where U: DynamicTokens,

Replaces the interior of a DynNode at all locations that cloned this, returns the old content.

Source

pub fn replace_here_with<U>(&mut self, this: U) -> DynNode<T>
where U: DynamicTokens,

Detaches this DynNode, insert new content, returns Self with the old content.

Source

pub fn downcast_ref<U>(&self) -> Option<Ref<'_, U>>
where U: DynamicTokens,

Casts a DynNode to a reference to a concrete type. Will return None on type error.

Trait Implementations§

Source§

impl<T> Clone for DynNode<T>
where T: Clone,

Source§

fn clone(&self) -> DynNode<T>

Returns a duplicate of the value. Read more
1.0.0 · Source§

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

Performs copy-assignment from source. Read more
Source§

impl<T> Debug for DynNode<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> Parser for DynNode<T>
where T: Parse + DynamicTokens,

Source§

fn parser(tokens: &mut TokenIter) -> Result<DynNode<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 DynNode<T>

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 DynNode<T>

§

impl<T = Nothing> !RefUnwindSafe for DynNode<T>

§

impl<T = Nothing> !Send for DynNode<T>

§

impl<T = Nothing> !Sync for DynNode<T>

§

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

§

impl<T = Nothing> !UnwindSafe for DynNode<T>

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> CloneToUninit for T
where T: Clone,

Source§

unsafe fn clone_to_uninit(&self, dest: *mut u8)

🔬This is a nightly-only experimental API. (clone_to_uninit)
Performs copy-assignment from self to dest. 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> ToOwned for T
where T: Clone,

Source§

type Owned = T

The resulting type after obtaining ownership.
Source§

fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
Source§

fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. 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.