Struct rustc_errors::Handler

pub struct Handler {
    pub flags: HandlerFlags,
    // some fields omitted
}

A handler deals with errors and other compiler output. Certain errors (fatal, bug, unimpl) may cause immediate exit, others log errors for later reporting.

Fields

flags: HandlerFlags

Methods

impl Handler

pub fn with_tty_emitter(
    color_config: ColorConfig,
    can_emit_warnings: bool,
    treat_err_as_bug: Option<usize>,
    cm: Option<Lrc<SourceMapperDyn>>
) -> Handler

pub fn with_tty_emitter_and_flags(
    color_config: ColorConfig,
    cm: Option<Lrc<SourceMapperDyn>>,
    flags: HandlerFlags
) -> Handler

pub fn with_emitter(
    can_emit_warnings: bool,
    treat_err_as_bug: Option<usize>,
    e: Box<dyn Emitter + Send>
) -> Handler

pub fn with_emitter_and_flags(
    e: Box<dyn Emitter + Send>,
    flags: HandlerFlags
) -> Handler

pub fn set_continue_after_error(&self, continue_after_error: bool)

pub fn reset_err_count(&self)

Resets the diagnostic error count as well as the cached emitted diagnostics.

NOTE: do not call this function from rustc. It is only meant to be called from external tools that want to reuse a Parser cleaning the previously emitted diagnostics as well as the overall count of emitted error diagnostics.

pub fn struct_dummy<'a>(&'a self) -> DiagnosticBuilder<'a>

pub fn struct_span_warn<'a, S: Into<MultiSpan>>(
    &'a self,
    sp: S,
    msg: &str
) -> DiagnosticBuilder<'a>

pub fn struct_span_warn_with_code<'a, S: Into<MultiSpan>>(
    &'a self,
    sp: S,
    msg: &str,
    code: DiagnosticId
) -> DiagnosticBuilder<'a>

pub fn struct_warn<'a>(&'a self, msg: &str) -> DiagnosticBuilder<'a>

pub fn struct_span_err<'a, S: Into<MultiSpan>>(
    &'a self,
    sp: S,
    msg: &str
) -> DiagnosticBuilder<'a>

pub fn struct_span_err_with_code<'a, S: Into<MultiSpan>>(
    &'a self,
    sp: S,
    msg: &str,
    code: DiagnosticId
) -> DiagnosticBuilder<'a>

pub fn struct_err<'a>(&'a self, msg: &str) -> DiagnosticBuilder<'a>

pub fn struct_err_with_code<'a>(
    &'a self,
    msg: &str,
    code: DiagnosticId
) -> DiagnosticBuilder<'a>

pub fn struct_span_fatal<'a, S: Into<MultiSpan>>(
    &'a self,
    sp: S,
    msg: &str
) -> DiagnosticBuilder<'a>

pub fn struct_span_fatal_with_code<'a, S: Into<MultiSpan>>(
    &'a self,
    sp: S,
    msg: &str,
    code: DiagnosticId
) -> DiagnosticBuilder<'a>

pub fn struct_fatal<'a>(&'a self, msg: &str) -> DiagnosticBuilder<'a>

pub fn cancel(&self, err: &mut DiagnosticBuilder)

pub fn span_fatal<S: Into<MultiSpan>>(&self, sp: S, msg: &str) -> FatalError

pub fn span_fatal_with_code<S: Into<MultiSpan>>(
    &self,
    sp: S,
    msg: &str,
    code: DiagnosticId
) -> FatalError

pub fn span_err<S: Into<MultiSpan>>(&self, sp: S, msg: &str)

pub fn mut_span_err<'a, S: Into<MultiSpan>>(
    &'a self,
    sp: S,
    msg: &str
) -> DiagnosticBuilder<'a>

pub fn span_err_with_code<S: Into<MultiSpan>>(
    &self,
    sp: S,
    msg: &str,
    code: DiagnosticId
)

pub fn span_warn<S: Into<MultiSpan>>(&self, sp: S, msg: &str)

pub fn span_warn_with_code<S: Into<MultiSpan>>(
    &self,
    sp: S,
    msg: &str,
    code: DiagnosticId
)

pub fn span_bug<S: Into<MultiSpan>>(&self, sp: S, msg: &str) -> !

pub fn delay_span_bug<S: Into<MultiSpan>>(&self, sp: S, msg: &str)

pub fn span_bug_no_panic<S: Into<MultiSpan>>(&self, sp: S, msg: &str)

pub fn span_note_without_error<S: Into<MultiSpan>>(&self, sp: S, msg: &str)

pub fn span_note_diag<'a>(
    &'a self,
    sp: Span,
    msg: &str
) -> DiagnosticBuilder<'a>

pub fn span_unimpl<S: Into<MultiSpan>>(&self, sp: S, msg: &str) -> !

pub fn failure(&self, msg: &str)

pub fn fatal(&self, msg: &str) -> FatalError

pub fn err(&self, msg: &str)

pub fn warn(&self, msg: &str)

pub fn note_without_error(&self, msg: &str)

pub fn bug(&self, msg: &str) -> !

pub fn unimpl(&self, msg: &str) -> !

pub fn err_count(&self) -> usize

pub fn has_errors(&self) -> bool

pub fn print_error_count(&self, registry: &Registry)

pub fn abort_if_errors(&self)

pub fn emit(&self, msp: &MultiSpan, msg: &str, lvl: Level)

pub fn emit_with_code(
    &self,
    msp: &MultiSpan,
    msg: &str,
    code: DiagnosticId,
    lvl: Level
)

pub fn must_teach(&self, code: &DiagnosticId) -> bool

true if we haven't taught a diagnostic with this code already. The caller must then teach the user about such a diagnostic.

Used to suppress emitting the same error multiple times with extended explanation when calling -Zteach.

pub fn force_print_db(&self, db: DiagnosticBuilder)

pub fn emit_artifact_notification(&self, path: &Path, artifact_type: &str)

Trait Implementations

impl Drop for Handler

fn drop(&mut self)

Executes the destructor for this type.