Rust 近似引用

此crate提供了将 Rust 语法树数据结构转换为源代码标记的宏 quote!。

Rust 的过程宏接收一个标记流作为输入，执行任意 Rust 代码以确定如何操作这些标记，并生成一个标记流返回给编译器以编译成调用者的 crate。近似引用是解决这个问题的一部分——产生返回给编译器的标记。

近似引用的想法是我们编写将视为 数据 的 代码。在 quote! 宏内部，我们可以编写看起来像代码的内容，就像我们的文本编辑器或 IDE 中的内容。我们得到编辑器括号匹配、语法高亮、缩进和可能的自动完成的全部好处。但是，我们不是将其作为代码编译到当前 crate 中，而是将其作为数据处理，传递它，修改它，最终将其作为标记返回给编译器以编译到宏调用者的 crate 中。

此crate由过程宏使用案例激发，但是一个通用的 Rust 近似引用库，并不特定于过程宏。

版本要求：Quote 支持 Rust 1.15.0 中对过程宏的第一个支持以来的任何编译器版本。

[dependencies]
quote = "0.4"

#[macro_use]
extern crate quote;

语法

quote crate提供了一个 quote! 宏，在其中可以编写 Rust 代码，这些代码被打包成一个 quote::Tokens 并可以作为数据处理。你应该将 Tokens 视为一个 Rust 源代码片段的表示。在 Tokens 上调用 to_string() 以将源代码片段作为字符串返回，或在过程宏中调用 into() 以将它们作为 TokenStream 流式传输回编译器。

在quote!宏中，插值是通过#var来完成的。任何实现了quote::ToTokens特质的类型都可以进行插值。这包括大多数Rust基本类型以及syn中的大多数语法树类型。

let tokens = quote! {
    struct SerializeWith #generics #where_clause {
        value: &'a #field_ty,
        phantom: ::std::marker::PhantomData<#item_ty>,
    }

    impl #generics serde::Serialize for SerializeWith #generics #where_clause {
        fn serialize<S>(&self, s: &mut S) -> Result<(), S::Error>
            where S: serde::Serializer
        {
            #path(self.value, s)
        }
    }

    SerializeWith {
        value: #value,
        phantom: ::std::marker::PhantomData::<#item_ty>,
    }
};

重复

重复操作使用#(...)*或#(...),*，类似于macro_rules!。这遍历重复内插值的任何变量的元素，并为每个元素插入重复体副本。插值中的变量可以是任何实现了IntoIterator的类型，包括Vec或现有的迭代器。