Struct DiagBuilder 

pub struct DiagBuilder<'a, G>
where
    G: EmissionGuarantee,
{ /* private fields */ }

Used for emitting structured error messages and other diagnostic information.

Note: Incorrect usage of this type results in a panic when dropped. This is to ensure that all errors are either emitted or cancelled.

Implementations

impl<'a, G> DiagBuilder<'a, G>

where G: EmissionGuarantee,

pub fn new<M>(dcx: &'a DiagCtxt, level: Level, msg: M) -> DiagBuilder<'a, G>

where M: Into<DiagMsg>,

Creates a new DiagBuilder.

pub fn dcx(&self) -> &DiagCtxt

Returns the DiagCtxt.

pub fn emit(self) -> <G as EmissionGuarantee>::EmitResult

Emits the diagnostic.

pub fn cancel(self)

Cancel the diagnostic (a structured diagnostic must either be emitted or cancelled or it will panic when dropped).

impl<G> DiagBuilder<'_, G>

where G: EmissionGuarantee,

Forwarded methods to Diag.

pub fn span(self, span: impl Into<MultiSpan>) -> DiagBuilder<'_, G>

See Diag::span().

pub fn code(self, code: impl Into<DiagId>) -> DiagBuilder<'_, G>

See Diag::code().

pub fn span_label( self, span: Span, label: impl Into<DiagMsg>, ) -> DiagBuilder<'_, G>

See Diag::span_label().

pub fn span_labels( self, spans: impl IntoIterator<Item = Span>, label: impl Into<DiagMsg>, ) -> DiagBuilder<'_, G>

See Diag::span_labels().

pub fn warn(self, msg: impl Into<DiagMsg>) -> DiagBuilder<'_, G>

See Diag::warn().

pub fn span_warn( self, span: impl Into<MultiSpan>, msg: impl Into<DiagMsg>, ) -> DiagBuilder<'_, G>

See Diag::span_warn().

pub fn note(self, msg: impl Into<DiagMsg>) -> DiagBuilder<'_, G>

See Diag::note().

pub fn span_note( self, span: impl Into<MultiSpan>, msg: impl Into<DiagMsg>, ) -> DiagBuilder<'_, G>

See Diag::span_note().

pub fn highlighted_note( self, messages: Vec<(impl Into<DiagMsg>, Style)>, ) -> DiagBuilder<'_, G>

See Diag::highlighted_note().

pub fn note_once(self, msg: impl Into<DiagMsg>) -> DiagBuilder<'_, G>

See Diag::note_once().

pub fn span_note_once( self, span: impl Into<MultiSpan>, msg: impl Into<DiagMsg>, ) -> DiagBuilder<'_, G>

See Diag::span_note_once().

pub fn help(self, msg: impl Into<DiagMsg>) -> DiagBuilder<'_, G>

See Diag::help().

pub fn help_once(self, msg: impl Into<DiagMsg>) -> DiagBuilder<'_, G>

See Diag::help_once().

pub fn highlighted_help( self, messages: Vec<(impl Into<DiagMsg>, Style)>, ) -> DiagBuilder<'_, G>

See Diag::highlighted_help().

pub fn span_help( self, span: impl Into<MultiSpan>, msg: impl Into<DiagMsg>, ) -> DiagBuilder<'_, G>

See Diag::span_help().

pub fn span_suggestion( self, span: Span, msg: impl Into<DiagMsg>, suggestion: impl Into<DiagMsg>, applicability: Applicability, ) -> DiagBuilder<'_, G>

See Diag::span_suggestion().

pub fn span_suggestion_with_style( self, span: Span, msg: impl Into<DiagMsg>, suggestion: impl Into<DiagMsg>, applicability: Applicability, style: SuggestionStyle, ) -> DiagBuilder<'_, G>

See Diag::span_suggestion_with_style().

pub fn multipart_suggestion( self, msg: impl Into<DiagMsg>, substitutions: Vec<(Span, DiagMsg)>, applicability: Applicability, ) -> DiagBuilder<'_, G>

See Diag::multipart_suggestion().

pub fn multipart_suggestion_with_style( self, msg: impl Into<DiagMsg>, substitutions: Vec<(Span, DiagMsg)>, applicability: Applicability, style: SuggestionStyle, ) -> DiagBuilder<'_, G>

See Diag::multipart_suggestion_with_style().

Methods from Deref<Target = Diag>

pub fn is_error(&self) -> bool

Returns true if this diagnostic is an error.

pub fn is_note(&self) -> bool

Returns true if this diagnostic is a note.

pub fn label(&self) -> Cow<'_, str>

Formats the diagnostic messages into a single string.

pub fn label_with_style(&self, supports_color: bool) -> Cow<'_, str>

Formats the diagnostic messages into a single string with ANSI color codes if applicable.

pub fn messages(&self) -> &[(DiagMsg, Style)]

Returns the messages of this diagnostic.

pub fn level(&self) -> Level

Returns the level of this diagnostic.

pub fn id(&self) -> Option<String>

Returns the code of this diagnostic as a string.

pub fn span(&mut self, span: impl Into<MultiSpan>) -> &mut Diag

Sets the span of this diagnostic.

pub fn code(&mut self, code: impl Into<DiagId>) -> &mut Diag

Sets the code of this diagnostic.

pub fn span_label(&mut self, span: Span, label: impl Into<DiagMsg>) -> &mut Diag

Adds a span/label to be included in the resulting snippet.

This is pushed onto the MultiSpan that was created when the diagnostic was first built. That means it will be shown together with the original span/label, not a span added by one of the span_{note,warn,help,suggestions} methods.

This span is not considered a “primary span”; only the Span supplied when creating the diagnostic is primary.

pub fn span_labels( &mut self, spans: impl IntoIterator<Item = Span>, label: impl Into<DiagMsg>, ) -> &mut Diag

Labels all the given spans with the provided label. See Self::span_label() for more information.

pub fn warn(&mut self, msg: impl Into<DiagMsg>) -> &mut Diag

Add a warning attached to this diagnostic.

pub fn span_warn( &mut self, span: impl Into<MultiSpan>, msg: impl Into<DiagMsg>, ) -> &mut Diag

Prints the span with a warning above it. This is like Diag::warn(), but it gets its own span.

pub fn note(&mut self, msg: impl Into<DiagMsg>) -> &mut Diag

Add a note to this diagnostic.

pub fn span_note( &mut self, span: impl Into<MultiSpan>, msg: impl Into<DiagMsg>, ) -> &mut Diag

Prints the span with a note above it. This is like Diag::note(), but it gets its own span.

pub fn highlighted_note( &mut self, messages: Vec<(impl Into<DiagMsg>, Style)>, ) -> &mut Diag

pub fn note_once(&mut self, msg: impl Into<DiagMsg>) -> &mut Diag

Prints the span with a note above it. This is like Diag::note(), but it gets emitted only once.

pub fn span_note_once( &mut self, span: impl Into<MultiSpan>, msg: impl Into<DiagMsg>, ) -> &mut Diag

Prints the span with a note above it. This is like Diag::note_once(), but it gets its own span.

pub fn help(&mut self, msg: impl Into<DiagMsg>) -> &mut Diag

Add a help message attached to this diagnostic.

pub fn help_once(&mut self, msg: impl Into<DiagMsg>) -> &mut Diag

Prints the span with a help above it. This is like Diag::help(), but it gets its own span.

pub fn highlighted_help( &mut self, msgs: Vec<(impl Into<DiagMsg>, Style)>, ) -> &mut Diag

Add a help message attached to this diagnostic with a customizable highlighted message.

pub fn span_help( &mut self, span: impl Into<MultiSpan>, msg: impl Into<DiagMsg>, ) -> &mut Diag

Prints the span with some help above it. This is like Diag::help(), but it gets its own span.

pub fn disable_suggestions(&mut self) -> &mut Diag

Disallow attaching suggestions to this diagnostic. Any suggestions attached e.g. with the span_suggestion_* methods (before and after the call to disable_suggestions) will be ignored.

pub fn seal_suggestions(&mut self) -> &mut Diag

Prevent new suggestions from being added to this diagnostic.

Suggestions added before the call to .seal_suggestions() will be preserved and new suggestions will be ignored.

pub fn span_suggestion( &mut self, span: Span, msg: impl Into<DiagMsg>, suggestion: impl Into<DiagMsg>, applicability: Applicability, ) -> &mut Diag

Prints out a message with a suggested edit of the code.

In case of short messages and a simple suggestion, rustc displays it as a label:

try adding parentheses: `(tup.0).1`

The message

• should not end in any punctuation (a : is added automatically)
• should not be a question (avoid language like “did you mean”)
• should not contain any phrases like “the following”, “as shown”, etc.
• may look like “to do xyz, use” or “to do xyz, use abc”
• may contain a name of a function, variable, or type, but not whole expressions

See CodeSuggestion for more information.

pub fn span_suggestion_with_style( &mut self, span: Span, msg: impl Into<DiagMsg>, suggestion: impl Into<DiagMsg>, applicability: Applicability, style: SuggestionStyle, ) -> &mut Diag

Diag::span_suggestion() but you can set the SuggestionStyle.

pub fn multipart_suggestion( &mut self, msg: impl Into<DiagMsg>, substitutions: Vec<(Span, DiagMsg)>, applicability: Applicability, ) -> &mut Diag

Show a suggestion that has multiple parts to it. In other words, multiple changes need to be applied as part of this suggestion.

pub fn multipart_suggestion_with_style( &mut self, msg: impl Into<DiagMsg>, substitutions: Vec<(Span, DiagMsg)>, applicability: Applicability, style: SuggestionStyle, ) -> &mut Diag

Diag::multipart_suggestion() but you can set the SuggestionStyle.

Trait Implementations

impl<G> Clone for DiagBuilder<'_, G>

where G: EmissionGuarantee,

fn clone(&self) -> DiagBuilder<'_, G>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<G> Debug for DiagBuilder<'_, G>

where G: EmissionGuarantee,

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

Formats the value using the given formatter.

impl<G> Deref for DiagBuilder<'_, G>

where G: EmissionGuarantee,

type Target = Diag

The resulting type after dereferencing.

fn deref(&self) -> &<DiagBuilder<'_, G> as Deref>::Target

Dereferences the value.

impl<G> DerefMut for DiagBuilder<'_, G>

where G: EmissionGuarantee,

fn deref_mut(&mut self) -> &mut <DiagBuilder<'_, G> as Deref>::Target

Mutably dereferences the value.

impl<G> Drop for DiagBuilder<'_, G>

where G: EmissionGuarantee,

fn drop(&mut self)

Executes the destructor for this type.