yap

Releases

1. ▸▾0.12.018 Nov 2023

   Add Tokens::parse method, which attempt to parse the remaining tokens into some type via FromStr (and str::parse). This requires a buffer type (often

   From #13:

   • Add Tokens::parse method, which attempt to parse the remaining tokens into some type via FromStr (and str::parse). This requires a buffer type (often String) to be provided as the second generic arg, and may use this to buffer tokens prior to parsing if necessary.
   • Add some helper functions which allow Tokens::parse to be optimised in cases like StrToken, so that eg calling toks.slice(from, to).parse::<u16,String> for StrTokens and similar won't allocate.
   • Add Tokens::take for taking n tokens (can be useful in conjunction with parse, above).
   • Add Tokens::eof, Tokens::collect and Tokens::consume for finding an EOF (None), collecting tokens and consuming all tokens.
   • Add Tokens::into_iter, for when you need to work around lifetime issues with Tokens::as_iter.
   • Rename Tokens::tokens_while to Tokens::take_while, and Tokens::skip_tokens_while to Tokens::skip_while; we no longer have to worry about conflicts with Iterator methods.
   • Tokens::{surrounded, optional, optional_err} now accept an FnOnce instead of an FnMut, allowing a little more flexibility in what is given.
   • Anything which returned something implementing Iterator now returns something implementing Tokens instead (you can still call .as_iter() to then get a standard Iterator from this).

   A shoutout to @EasyOakland for their contributions in this!

   From #13:

   • Add yap::chars module which contains some helper functions (like parse_f64) specific to impl Tokens<Item=char>.
   • Generalise yap::one_of! and Tokens::optional; the output from expressions passed to either of these can now be Option<T> or bool, or more specifically anything implementing yap::one_of::IsMatch.