# Struct proc_macro::Diagnostic

source ·

    pub struct Diagnostic { /* private fields */ }

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)
Expand description

A structure representing a diagnostic message and associated children messages.

## Implementations§

source§

### impl Diagnostic

source

#### pub fn new<T: Into<String>>(level: Level, message: T) -> Diagnostic

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Creates a new diagnostic with the given `level` and `message`.

source

#### pub fn spanned<S, T>(spans: S, level: Level, message: T) -> Diagnostic where S: MultiSpan, T: Into<String>,

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Creates a new diagnostic with the given `level` and `message` pointing to the given set of `spans`.

source

#### pub fn span_error<S, T>(self, spans: S, message: T) -> Diagnostic where S: MultiSpan, T: Into<String>,

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Adds a new child diagnostics message to `self` with the `Level::Error` level, and the given `spans` and `message`.

source

#### pub fn error<T: Into<String>>(self, message: T) -> Diagnostic

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Adds a new child diagnostic message to `self` with the `Level::Error` level, and the given `message`.

source

#### pub fn span_warning<S, T>(self, spans: S, message: T) -> Diagnostic where S: MultiSpan, T: Into<String>,

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Adds a new child diagnostics message to `self` with the `Level::Warning` level, and the given `spans` and `message`.

source

#### pub fn warning<T: Into<String>>(self, message: T) -> Diagnostic

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Adds a new child diagnostic message to `self` with the `Level::Warning` level, and the given `message`.

source

#### pub fn span_note<S, T>(self, spans: S, message: T) -> Diagnostic where S: MultiSpan, T: Into<String>,

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Adds a new child diagnostics message to `self` with the `Level::Note` level, and the given `spans` and `message`.

source

#### pub fn note<T: Into<String>>(self, message: T) -> Diagnostic

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Adds a new child diagnostic message to `self` with the `Level::Note` level, and the given `message`.

source

#### pub fn span_help<S, T>(self, spans: S, message: T) -> Diagnostic where S: MultiSpan, T: Into<String>,

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Adds a new child diagnostics message to `self` with the `Level::Help` level, and the given `spans` and `message`.

source

#### pub fn help<T: Into<String>>(self, message: T) -> Diagnostic

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Adds a new child diagnostic message to `self` with the `Level::Help` level, and the given `message`.

source

#### pub fn level(&self) -> Level

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Returns the diagnostic `level` for `self`.

source

#### pub fn set_level(&mut self, level: Level)

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Sets the level in `self` to `level`.

source

#### pub fn message(&self) -> &str

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Returns the message in `self`.

source

#### pub fn set_message<T: Into<String>>(&mut self, message: T)

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Sets the message in `self` to `message`.

source

#### pub fn spans(&self) -> &[Span]

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Returns the `Span`s in `self`.

source

#### pub fn set_spans<S: MultiSpan>(&mut self, spans: S)

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Sets the `Span`s in `self` to `spans`.

source

#### pub fn children(&self) -> Children<'_>

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Returns an iterator over the children diagnostics of `self`.

source

#### pub fn emit(self)

🔬This is a nightly-only experimental API. (`proc_macro_diagnostic` #54140)

Emit the diagnostic.

## Trait Implementations§

source§

### impl Clone for Diagnostic

source§

#### fn clone(&self) -> Diagnostic

Returns a copy of the value. Read more
1.0.0 · source§

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

Performs copy-assignment from `source`. Read more
source§

### impl Debug for Diagnostic

source§

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

Formats the value using the given formatter. Read more

## Auto Trait Implementations§

§

### impl RefUnwindSafe for Diagnostic

§

### impl !Send for Diagnostic

§

### impl !Sync for Diagnostic

§

### impl Unpin for Diagnostic

§

### impl UnwindSafe for Diagnostic

## Blanket Implementations§

source§

### impl<T> Any for Twhere T: 'static + ?Sized,

source§

#### fn type_id(&self) -> TypeId

Gets the `TypeId` of `self`. Read more
source§

### impl<T> Borrow<T> for Twhere T: ?Sized,

source§

#### fn borrow(&self) -> &T

Immutably borrows from an owned value. Read more
source§

### impl<T> BorrowMut<T> for Twhere T: ?Sized,

source§

#### fn borrow_mut(&mut self) -> &mut T

Mutably borrows from an owned value. Read more
source§

### impl<T> From<T> for T

source§

#### fn from(t: T) -> T

Returns the argument unchanged.

source§

### impl<T, U> Into<U> for Twhere U: From<T>,

source§

#### fn into(self) -> U

Calls `U::from(self)`.

That is, this conversion is whatever the implementation of `From<T> for U` chooses to do.

source§

### impl<T> ToOwned for Twhere T: Clone,

§

#### type Owned = T

The resulting type after obtaining ownership.
source§

#### fn to_owned(&self) -> T

Creates owned data from borrowed data, usually by cloning. Read more
source§

#### fn clone_into(&self, target: &mut T)

Uses borrowed data to replace owned data, usually by cloning. Read more
source§

### impl<T, U> TryFrom<U> for Twhere U: Into<T>,

§

#### type Error = Infallible

The type returned in the event of a conversion error.
source§

#### fn try_from(value: U) -> Result<T, <T as TryFrom<U>>::Error>

Performs the conversion.
source§

### impl<T, U> TryInto<U> for Twhere U: TryFrom<T>,

§

#### type Error = <U as TryFrom<T>>::Error

The type returned in the event of a conversion error.
source§

#### fn try_into(self) -> Result<U, <U as TryFrom<T>>::Error>

Performs the conversion.