Struct Literal

pub struct Literal(/* private fields */);

字面量字符串 ("hello")、字节字符串 (b"hello")、C 字符串 (c"hello")、字符 ('a')、字节字符 (b'a')、带或不带后缀的整数或浮点数 (1, 1u8, 2.3, 2.3f32)。 像 true 和 false 这样的布尔字面量不属于这里，它们是 Ident。

实现

impl Literal

pub fn u8_suffixed(n: u8) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u16_suffixed(n: u16) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u32_suffixed(n: u32) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u64_suffixed(n: u64) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u128_suffixed(n: u128) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn usize_suffixed(n: usize) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i8_suffixed(n: i8) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i16_suffixed(n: i16) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i32_suffixed(n: i32) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i64_suffixed(n: i64) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i128_suffixed(n: i128) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn isize_suffixed(n: isize) -> Literal

创建带有指定值的新后缀整数文字。

此函数将创建一个类似 1u32 的整数，其中指定的整数值是 token 的第一部分，并且整数也在末尾添加了后缀。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u8_unsuffixed(n: u8) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u16_unsuffixed(n: u16) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u32_unsuffixed(n: u32) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u64_unsuffixed(n: u64) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn u128_unsuffixed(n: u128) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn usize_unsuffixed(n: usize) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i8_unsuffixed(n: i8) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i16_unsuffixed(n: i16) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i32_unsuffixed(n: i32) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i64_unsuffixed(n: i64) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn i128_unsuffixed(n: i128) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn isize_unsuffixed(n: isize) -> Literal

创建带有指定值的新无后缀整数文字。

此函数将创建一个类似 1 的整数，其中指定的整数值是 token 的第一部分。 此 token 上未指定后缀，这意味着像 Literal::i8_unsuffixed(1) 这样的调用等效于 Literal::u32_unsuffixed(1)。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

通过此方法创建的字面量默认具有 Span::call_site() span，可以使用下面的 set_span 方法进行配置。

pub fn f32_unsuffixed(n: f32) -> Literal

创建新的无后缀浮点文字。

此构造函数类似于 Literal::i8_unsuffixed 等，其中浮点值直接发射到 token 中，但不使用后缀，因此稍后在编译器中可能会推断为 f64。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

Panics

此函数要求指定的浮点数是有限的，例如，如果它是无穷大或 NaN，则此函数将 panic。

pub fn f32_suffixed(n: f32) -> Literal

创建新的后缀浮点文字。

此构造函数将创建一个类似 1.0f32 的字面量，其中指定的值是 token 的前一部分，而 f32 是 token 的后缀。 此 token 将始终在编译器中被推断为 f32。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

Panics

此函数要求指定的浮点数是有限的，例如，如果它是无穷大或 NaN，则此函数将 panic。

pub fn f64_unsuffixed(n: f64) -> Literal

创建新的无后缀浮点文字。

此构造函数类似于 Literal::i8_unsuffixed 等，其中浮点值直接发射到 token 中，但不使用后缀，因此稍后在编译器中可能会推断为 f64。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

Panics

此函数要求指定的浮点数是有限的，例如，如果它是无穷大或 NaN，则此函数将 panic。

pub fn f64_suffixed(n: f64) -> Literal

创建新的后缀浮点文字。

此构造函数将创建一个类似 1.0f64 的字面量，其中指定的值是 token 的前一部分，而 f64 是 token 的后缀。 此 token 将始终在编译器中被推断为 f64。 通过负数创建的字面量可能无法在 TokenStream 或字符串之间往返，并且可能会分成两个 token (- 和正字面量)。

Panics

此函数要求指定的浮点数是有限的，例如，如果它是无穷大或 NaN，则此函数将 panic。

pub fn string(string: &str) -> Literal

字符串字面量。

pub fn character(ch: char) -> Literal

字符字面量。

pub fn byte_character(byte: u8) -> Literal

字节字符字面量。

pub fn byte_string(bytes: &[u8]) -> Literal

字节串字面量。

pub fn c_string(string: &CStr) -> Literal

C 字符串字面量。

pub fn span(&self) -> Span

返回包含此字面量的 span。

pub fn set_span(&mut self, span: Span)

配置与此字面量关联的 span。

pub fn subspan<R: RangeBounds<usize>>(&self, range: R) -> Option<Span>

🔬这是一个仅限 nightly 的实验性 API。(proc_macro_span #54725)

返回一个 Span，它是 self.span() 的子集，仅包含 range 范围内的源字节。 如果修剪后的 span 超出 self 的边界，则返回 None。

Trait 实现

impl Clone for Literal

fn clone(&self) -> Literal

返回值的副本。 阅读更多

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

从 source 执行复制赋值。 阅读更多

impl Debug for Literal

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

使用给定的 formatter 格式化值。 阅读更多

impl Display for Literal

将字面量打印为字符串，该字符串应无损地转换回相同的字面量（浮点字面量可能存在舍入）。

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

使用给定的 formatter 格式化值。 阅读更多

impl From<Literal> for TokenTree

fn from(g: Literal) -> TokenTree

从输入类型转换为此类型。

impl FromStr for Literal

从其字符串化表示形式解析单个字面量。

为了成功解析，输入字符串必须仅包含字面量 token。 具体来说，除了字面量之外，它不能包含空格或注释。

生成的字面量 token 将具有 Span::call_site() span。

注意：某些错误可能会导致 panic 而不是返回 LexError。 我们保留稍后将这些错误更改为 LexError 的权利。

type Err = LexError

可以从解析返回的关联错误。

fn from_str(src: &str) -> Result<Self, LexError>

解析字符串 s 以返回此类型的值。 阅读更多

impl ToTokens for Literal

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

🔬这是一个仅限 nightly 的实验性 API。(proc_macro_totokens #130977)

将 self 写入给定的 TokenStream。 阅读更多

fn to_token_stream(&self) -> TokenStream

🔬这是一个仅限 nightly 的实验性 API。(proc_macro_totokens #130977)

将 self 直接转换为 TokenStream 对象。 阅读更多

fn into_token_stream(self) -> TokenStream

where Self: Sized,

🔬这是一个仅限 nightly 的实验性 API。(proc_macro_totokens #130977)

将 self 直接转换为 TokenStream 对象。 阅读更多