unquote

一个反向引号宏...也就是说，一个从 ParseStream 按照给定模式解析输入的宏。

注意：此库仍在开发中。虽然我不期望语法会有大的破坏性变化，但还有一些功能缺失，并且错误消息还不总是很好。

此宏当前需要当前命名空间中可用 syn，并且至少启用了 "extra-traits" 和 "parsing" 功能。这将在下一次较大的重构中得到修复。

安装

请使用 cargo-edit 来始终添加此库的最新版本

cargo add unquote

示例

use call2_for_syn::call2_strict;
use quote::quote;
use std::error::Error;
use syn::{LitStr, parse::ParseStream};
use unquote::unquote;

fn main() -> Result<(), Box<dyn Error>> {
  // Sample input
  let tokens = quote!(<!-- "Hello!" -->);

  // Analogous to a parser implementation with `syn`:
  fn parser_function(input: ParseStream) -> syn::Result<LitStr> {
    // Declare bindings ahead of time.
    // Rust can usually infer the type.
    let parsed;

    // This uses the ? operator internally -
    // It needs to be inside a `Result`-returning function.
    unquote!(input, <!-- #parsed -->);

    Ok(parsed)
  }

  let parsed = call2_strict(tokens, parser_function)??;
  assert_eq!(parsed.value(), "Hello!");
  Ok(())
}

实现状态

（按优先级顺序大致排列）

¹ 注意，所有可变参数在第一个TokenTree之后都是急切的，并且只进行非常浅的推测性解析！在实践中，这意味着例如将++解析为#(+-)?++将会失败，因为第一个+ "锁定"了可选短语。