# Struct proc_macro::Literal[−][src]

    pub struct Literal { /* fields omitted */ }

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

A literal character (`'a'`), string (`"hello"`), a number (`2.3`), etc.

## Methods

###

`impl Literal`

[src]

####

`pub fn u8_suffixed(n: u8) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u16_suffixed(n: u16) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u32_suffixed(n: u32) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u64_suffixed(n: u64) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u128_suffixed(n: u128) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn usize_suffixed(n: usize) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i8_suffixed(n: i8) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i16_suffixed(n: i16) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i32_suffixed(n: i32) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i64_suffixed(n: i64) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i128_suffixed(n: i128) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn isize_suffixed(n: isize) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed integer literal with the specified value.

This function will create an integer like `1u32` where the integer value specified is the first part of the token and the integral is also suffixed at the end.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u8_unsuffixed(n: u8) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u16_unsuffixed(n: u16) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u32_unsuffixed(n: u32) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u64_unsuffixed(n: u64) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn u128_unsuffixed(n: u128) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn usize_unsuffixed(n: usize) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i8_unsuffixed(n: i8) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i16_unsuffixed(n: i16) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i32_unsuffixed(n: i32) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i64_unsuffixed(n: i64) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn i128_unsuffixed(n: i128) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn isize_unsuffixed(n: isize) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed integer literal with the specified value.

This function will create an integer like `1` where the integer value specified is the first part of the token. No suffix is specified on this token, meaning that invocations like `Literal::i8_unsuffixed(1)` are equivalent to `Literal::u32_unsuffixed(1)`.

Literals created through this method have the `Span::call_site()` span by default, which can be configured with the `set_span` method below.

####

`pub fn f32_unsuffixed(n: f32) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed floating-point literal.

This constructor is similar to those like `Literal::i8_unsuffixed` where the float's value is emitted directly into the token but no suffix is used, so it may be inferred to be a `f64` later in the compiler.

# Panics

This function requires that the specified float is finite, for example if it is infinity or NaN this function will panic.

####

`pub fn f32_suffixed(n: f32) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed floating-point literal.

This consturctor will create a literal like `1.0f32` where the value specified is the preceding part of the token and `f32` is the suffix of the token. This token will always be inferred to be an `f32` in the compiler.

# Panics

This function requires that the specified float is finite, for example if it is infinity or NaN this function will panic.

####

`pub fn f64_unsuffixed(n: f64) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new unsuffixed floating-point literal.

This constructor is similar to those like `Literal::i8_unsuffixed` where the float's value is emitted directly into the token but no suffix is used, so it may be inferred to be a `f64` later in the compiler.

# Panics

This function requires that the specified float is finite, for example if it is infinity or NaN this function will panic.

####

`pub fn f64_suffixed(n: f64) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Creates a new suffixed floating-point literal.

This consturctor will create a literal like `1.0f64` where the value specified is the preceding part of the token and `f64` is the suffix of the token. This token will always be inferred to be an `f64` in the compiler.

# Panics

This function requires that the specified float is finite, for example if it is infinity or NaN this function will panic.

####

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

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

String literal.

####

`pub fn character(ch: char) -> Literal`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Character literal.

####

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

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Byte string literal.

####

`pub fn span(&self) -> Span`

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Returns the span encompassing this literal.

####

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

[src]

🔬 This is a nightly-only experimental API. (`proc_macro` #38356)

Configures the span associated for this literal.

## Trait Implementations

###

`impl From<Literal> for TokenTree`

[src]

####

`fn from(g: Literal) -> TokenTree`

[src]

Performs the conversion.

###

`impl Clone for Literal`

[src]

####

`fn clone(&self) -> Literal`

[src]

Returns a copy of the value. Read more

####

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

1.0.0
[src]

Performs copy-assignment from `source`. Read more

###

`impl Debug for Literal`

[src]

####

`fn fmt(&self, f: &mut Formatter) -> Result`

[src]

Formats the value using the given formatter. Read more

###

`impl Display for Literal`

[src]

####

`fn fmt(&self, f: &mut Formatter) -> Result`

[src]

Formats the value using the given formatter. Read more

## Auto Trait Implementations

###

`impl !Send for Literal`

###

`impl !Sync for Literal`

# Help

## Keyboard Shortcuts

`?`
  Show this help dialog
`S`
  Focus the search field
`↑`
  Move up in search results
`↓`
  Move down in search results
`↹`
  Switch tab
`⏎`
  Go to active search result
`+`
  Expand all sections
`-`
  Collapse all sections

## Search Tricks

Prefix searches with a type followed by a colon (e.g. `fn:`) to restrict the search to a given type.

Accepted types are: `fn`, `mod`, `struct`, `enum`, `trait`, `type`, `macro`, and `const`.

Search functions by type signature (e.g. `vec -> usize` or `* -> vec`)

Search multiple things at once by splitting your query with comma (e.g. `str,u8` or `String,struct:Vec,test`)