clang  3.9.0
Classes | Public Types | Public Member Functions | Friends | List of all members
clang::DiagnosticsEngine Class Reference

Concrete class used by the front-end to report problems and issues. More...

#include <Diagnostic.h>

Inheritance diagram for clang::DiagnosticsEngine:
[legend]
Collaboration diagram for clang::DiagnosticsEngine:
[legend]

Public Types

enum  Level {
  Ignored = DiagnosticIDs::Ignored, Note = DiagnosticIDs::Note, Remark = DiagnosticIDs::Remark, Warning = DiagnosticIDs::Warning,
  Error = DiagnosticIDs::Error, Fatal = DiagnosticIDs::Fatal
}
 The level of the diagnostic, after it has been through mapping. More...
 
enum  ArgumentKind {
  ak_std_string, ak_c_string, ak_sint, ak_uint,
  ak_tokenkind, ak_identifierinfo, ak_qualtype, ak_declarationname,
  ak_nameddecl, ak_nestednamespec, ak_declcontext, ak_qualtype_pair,
  ak_attr
}
 
typedef std::pair
< ArgumentKind, intptr_t
ArgumentValue
 Represents on argument value, which is a union discriminated by ArgumentKind, with a value. More...
 
typedef llvm::iterator_range
< DiagState::const_iterator > 
diag_mapping_range
 

Public Member Functions

 DiagnosticsEngine (const IntrusiveRefCntPtr< DiagnosticIDs > &Diags, DiagnosticOptions *DiagOpts, DiagnosticConsumer *client=nullptr, bool ShouldOwnClient=true)
 
 ~DiagnosticsEngine ()
 
const IntrusiveRefCntPtr
< DiagnosticIDs > & 
getDiagnosticIDs () const
 
DiagnosticOptionsgetDiagnosticOptions () const
 Retrieve the diagnostic options. More...
 
diag_mapping_range getDiagnosticMappings () const
 Get the current set of diagnostic mappings. More...
 
DiagnosticConsumergetClient ()
 
const DiagnosticConsumergetClient () const
 
bool ownsClient () const
 Determine whether this DiagnosticsEngine object own its client. More...
 
std::unique_ptr
< DiagnosticConsumer
takeClient ()
 Return the current diagnostic client along with ownership of that client. More...
 
bool hasSourceManager () const
 
SourceManagergetSourceManager () const
 
void setSourceManager (SourceManager *SrcMgr)
 
void pushMappings (SourceLocation Loc)
 Copies the current DiagMappings and pushes the new copy onto the top of the stack. More...
 
bool popMappings (SourceLocation Loc)
 Pops the current DiagMappings off the top of the stack, causing the new top of the stack to be the active mappings. More...
 
void setClient (DiagnosticConsumer *client, bool ShouldOwnClient=true)
 Set the diagnostic client associated with this diagnostic object. More...
 
void setErrorLimit (unsigned Limit)
 Specify a limit for the number of errors we should emit before giving up. More...
 
void setTemplateBacktraceLimit (unsigned Limit)
 Specify the maximum number of template instantiation notes to emit along with a given diagnostic. More...
 
unsigned getTemplateBacktraceLimit () const
 Retrieve the maximum number of template instantiation notes to emit along with a given diagnostic. More...
 
void setConstexprBacktraceLimit (unsigned Limit)
 Specify the maximum number of constexpr evaluation notes to emit along with a given diagnostic. More...
 
unsigned getConstexprBacktraceLimit () const
 Retrieve the maximum number of constexpr evaluation notes to emit along with a given diagnostic. More...
 
void setIgnoreAllWarnings (bool Val)
 When set to true, any unmapped warnings are ignored. More...
 
bool getIgnoreAllWarnings () const
 
void setEnableAllWarnings (bool Val)
 When set to true, any unmapped ignored warnings are no longer ignored. More...
 
bool getEnableAllWarnings () const
 
void setWarningsAsErrors (bool Val)
 When set to true, any warnings reported are issued as errors. More...
 
bool getWarningsAsErrors () const
 
void setErrorsAsFatal (bool Val)
 When set to true, any error reported is made a fatal error. More...
 
bool getErrorsAsFatal () const
 
void setFatalsAsError (bool Val)
 When set to true, any fatal error reported is made an error. More...
 
bool getFatalsAsError () const
 
void setSuppressSystemWarnings (bool Val)
 When set to true mask warnings that come from system headers. More...
 
bool getSuppressSystemWarnings () const
 
void setSuppressAllDiagnostics (bool Val=true)
 Suppress all diagnostics, to silence the front end when we know that we don't want any more diagnostics to be passed along to the client. More...
 
bool getSuppressAllDiagnostics () const
 
void setElideType (bool Val=true)
 Set type eliding, to skip outputting same types occurring in template types. More...
 
bool getElideType ()
 
void setPrintTemplateTree (bool Val=false)
 Set tree printing, to outputting the template difference in a tree format. More...
 
bool getPrintTemplateTree ()
 
void setShowColors (bool Val=false)
 Set color printing, so the type diffing will inject color markers into the output. More...
 
bool getShowColors ()
 
void setShowOverloads (OverloadsShown Val)
 Specify which overload candidates to show when overload resolution fails. More...
 
OverloadsShown getShowOverloads () const
 
void setLastDiagnosticIgnored ()
 Pretend that the last diagnostic issued was ignored, so any subsequent notes will be suppressed. More...
 
bool isLastDiagnosticIgnored () const
 Determine whether the previous diagnostic was ignored. More...
 
void setExtensionHandlingBehavior (diag::Severity H)
 Controls whether otherwise-unmapped extension diagnostics are mapped onto ignore/warning/error. More...
 
diag::Severity getExtensionHandlingBehavior () const
 
void IncrementAllExtensionsSilenced ()
 Counter bumped when an extension block is/ encountered. More...
 
void DecrementAllExtensionsSilenced ()
 
bool hasAllExtensionsSilenced ()
 
void setSeverity (diag::kind Diag, diag::Severity Map, SourceLocation Loc)
 This allows the client to specify that certain warnings are ignored. More...
 
bool setSeverityForGroup (diag::Flavor Flavor, StringRef Group, diag::Severity Map, SourceLocation Loc=SourceLocation())
 Change an entire diagnostic group (e.g. More...
 
bool setDiagnosticGroupWarningAsError (StringRef Group, bool Enabled)
 Set the warning-as-error flag for the given diagnostic group. More...
 
bool setDiagnosticGroupErrorAsFatal (StringRef Group, bool Enabled)
 Set the error-as-fatal flag for the given diagnostic group. More...
 
void setSeverityForAll (diag::Flavor Flavor, diag::Severity Map, SourceLocation Loc=SourceLocation())
 Add the specified mapping to all diagnostics of the specified flavor. More...
 
bool hasErrorOccurred () const
 
bool hasUncompilableErrorOccurred () const
 Errors that actually prevent compilation, not those that are upgraded from a warning by -Werror. More...
 
bool hasFatalErrorOccurred () const
 
bool hasUnrecoverableErrorOccurred () const
 Determine whether any kind of unrecoverable error has occurred. More...
 
unsigned getNumWarnings () const
 
void setNumWarnings (unsigned NumWarnings)
 
template<unsigned N>
unsigned getCustomDiagID (Level L, const char(&FormatString)[N])
 Return an ID for a diagnostic with the specified format string and level. More...
 
void ConvertArgToString (ArgumentKind Kind, intptr_t Val, StringRef Modifier, StringRef Argument, ArrayRef< ArgumentValue > PrevArgs, SmallVectorImpl< char > &Output, ArrayRef< intptr_t > QualTypeVals) const
 Converts a diagnostic argument (as an intptr_t) into the string that represents it. More...
 
void SetArgToStringFn (ArgToStringFnTy Fn, void *Cookie)
 
void notePriorDiagnosticFrom (const DiagnosticsEngine &Other)
 Note that the prior diagnostic was emitted by some other DiagnosticsEngine, and we may be attaching a note to that diagnostic. More...
 
void Reset ()
 Reset the state of the diagnostic object to its initial configuration. More...
 
bool isIgnored (unsigned DiagID, SourceLocation Loc) const
 Determine whether the diagnostic is known to be ignored. More...
 
Level getDiagnosticLevel (unsigned DiagID, SourceLocation Loc) const
 Based on the way the client configured the DiagnosticsEngine object, classify the specified diagnostic ID into a Level, consumable by the DiagnosticConsumer. More...
 
DiagnosticBuilder Report (SourceLocation Loc, unsigned DiagID)
 Issue the message to the client. More...
 
DiagnosticBuilder Report (unsigned DiagID)
 
void Report (const StoredDiagnostic &storedDiag)
 
bool isDiagnosticInFlight () const
 Determine whethere there is already a diagnostic in flight. More...
 
void SetDelayedDiagnostic (unsigned DiagID, StringRef Arg1="", StringRef Arg2="")
 Set the "delayed" diagnostic that will be emitted once the current diagnostic completes. More...
 
void Clear ()
 Clear out the current diagnostic. More...
 
StringRef getFlagValue () const
 Return the value associated with this diagnostic flag. More...
 

Friends

class DiagnosticIDs
 
class DiagnosticBuilder
 
class Diagnostic
 
class PartialDiagnostic
 
class DiagnosticErrorTrap
 
class ASTReader
 
class ASTWriter
 

Diagnostic Emission

class Sema
 
bool EmitCurrentDiagnostic (bool Force=false)
 Emit the current diagnostic and clear the diagnostic state. More...
 
unsigned getCurrentDiagID () const
 
SourceLocation getCurrentDiagLoc () const
 

Detailed Description

Concrete class used by the front-end to report problems and issues.

This massages the diagnostics (e.g. handling things like "report warnings as errors" and passes them off to the DiagnosticConsumer for reporting to the user. DiagnosticsEngine is tied to one translation unit and one SourceManager.

Definition at line 135 of file Diagnostic.h.

Member Typedef Documentation

Represents on argument value, which is a union discriminated by ArgumentKind, with a value.

Definition at line 168 of file Diagnostic.h.

typedef llvm::iterator_range<DiagState::const_iterator> clang::DiagnosticsEngine::diag_mapping_range

Definition at line 361 of file Diagnostic.h.

Member Enumeration Documentation

Enumerator
ak_std_string 

std::string

ak_c_string 

const char *

ak_sint 

int

ak_uint 

unsigned

ak_tokenkind 

enum TokenKind : unsigned

ak_identifierinfo 

IdentifierInfo.

ak_qualtype 

QualType.

ak_declarationname 

DeclarationName.

ak_nameddecl 

NamedDecl *.

ak_nestednamespec 

NestedNameSpecifier *.

ak_declcontext 

DeclContext *.

ak_qualtype_pair 

pair<QualType, QualType>

ak_attr 

Attr *.

Definition at line 150 of file Diagnostic.h.

The level of the diagnostic, after it has been through mapping.

Enumerator
Ignored 
Note 
Remark 
Warning 
Error 
Fatal 

Definition at line 141 of file Diagnostic.h.

Constructor & Destructor Documentation

DiagnosticsEngine::DiagnosticsEngine ( const IntrusiveRefCntPtr< DiagnosticIDs > &  Diags,
DiagnosticOptions DiagOpts,
DiagnosticConsumer client = nullptr,
bool  ShouldOwnClient = true 
)
explicit
DiagnosticsEngine::~DiagnosticsEngine ( )

Definition at line 87 of file Diagnostic.cpp.

References setClient().

Member Function Documentation

void clang::DiagnosticsEngine::Clear ( )
inline
void clang::DiagnosticsEngine::ConvertArgToString ( ArgumentKind  Kind,
intptr_t  Val,
StringRef  Modifier,
StringRef  Argument,
ArrayRef< ArgumentValue PrevArgs,
SmallVectorImpl< char > &  Output,
ArrayRef< intptr_t QualTypeVals 
) const
inline

Converts a diagnostic argument (as an intptr_t) into the string that represents it.

Definition at line 616 of file Diagnostic.h.

Referenced by clang::Diagnostic::FormatDiagnostic().

void clang::DiagnosticsEngine::DecrementAllExtensionsSilenced ( )
inline

Definition at line 530 of file Diagnostic.h.

Referenced by clang::ExtensionRAIIObject::~ExtensionRAIIObject().

bool DiagnosticsEngine::EmitCurrentDiagnostic ( bool  Force = false)
protected

Emit the current diagnostic and clear the diagnostic state.

Parameters
ForceEmit the diagnostic regardless of suppression settings.

Definition at line 363 of file Diagnostic.cpp.

References Clear(), getClient(), clang::Diagnostic::getID(), clang::Diagnostic::getLocation(), and clang::DiagnosticIDs::Ignored.

Referenced by clang::DiagnosticBuilder::Emit(), and clang::Sema::EmitCurrentDiagnostic().

DiagnosticConsumer* clang::DiagnosticsEngine::getClient ( )
inline
const DiagnosticConsumer* clang::DiagnosticsEngine::getClient ( ) const
inline

Definition at line 370 of file Diagnostic.h.

unsigned clang::DiagnosticsEngine::getConstexprBacktraceLimit ( ) const
inline

Retrieve the maximum number of constexpr evaluation notes to emit along with a given diagnostic.

Definition at line 434 of file Diagnostic.h.

unsigned clang::DiagnosticsEngine::getCurrentDiagID ( ) const
inlineprotected

Definition at line 816 of file Diagnostic.h.

Referenced by clang::Sema::EmitCurrentDiagnostic().

SourceLocation clang::DiagnosticsEngine::getCurrentDiagLoc ( ) const
inlineprotected

Definition at line 818 of file Diagnostic.h.

Referenced by clang::Sema::EmitCurrentDiagnostic().

template<unsigned N>
unsigned clang::DiagnosticsEngine::getCustomDiagID ( Level  L,
const char(&)  FormatString[N] 
)
inline

Return an ID for a diagnostic with the specified format string and level.

If this is the first request for this diagnostic, it is registered and created, otherwise the existing ID is returned.

Parameters
FormatStringA fixed diagnostic format string that will be hashed and mapped to a unique DiagID.

Definition at line 609 of file Diagnostic.h.

Referenced by clang::CodeGen::CodeGenModule::CodeGenModule(), clang::CodeGen::CodeGenModule::Error(), clang::CodeGen::CodeGenModule::ErrorUnsupported(), clang::CodeGen::CGCXXABI::ErrorUnsupportedABI(), clang::CodeGenAction::ExecuteAction(), clang::TextDiagnosticBuffer::FlushDiagnostics(), InvalidPTH(), reportDiag(), and rewriteToNumericBoxedExpression().

const IntrusiveRefCntPtr<DiagnosticIDs>& clang::DiagnosticsEngine::getDiagnosticIDs ( ) const
inline
Level clang::DiagnosticsEngine::getDiagnosticLevel ( unsigned  DiagID,
SourceLocation  Loc 
) const
inline

Based on the way the client configured the DiagnosticsEngine object, classify the specified diagnostic ID into a Level, consumable by the DiagnosticConsumer.

To preserve invariant assumptions, this function should not be used to influence parse or semantic analysis actions. Instead consider using isIgnored().

Parameters
LocThe source location we are interested in finding out the diagnostic state. Can be null in order to query the latest state.

Definition at line 667 of file Diagnostic.h.

Referenced by checkDiagnosticGroupMappings().

diag_mapping_range clang::DiagnosticsEngine::getDiagnosticMappings ( ) const
inline

Get the current set of diagnostic mappings.

Definition at line 364 of file Diagnostic.h.

DiagnosticOptions& clang::DiagnosticsEngine::getDiagnosticOptions ( ) const
inline

Retrieve the diagnostic options.

Definition at line 359 of file Diagnostic.h.

Referenced by CheckResults(), clang::driver::tools::Clang::ConstructJob(), and clang::html::HighlightMacros().

bool clang::DiagnosticsEngine::getElideType ( )
inline

Definition at line 480 of file Diagnostic.h.

bool clang::DiagnosticsEngine::getEnableAllWarnings ( ) const
inline

Definition at line 449 of file Diagnostic.h.

Referenced by checkDiagnosticMappings().

bool clang::DiagnosticsEngine::getErrorsAsFatal ( ) const
inline

Definition at line 457 of file Diagnostic.h.

diag::Severity clang::DiagnosticsEngine::getExtensionHandlingBehavior ( ) const
inline

Definition at line 523 of file Diagnostic.h.

Referenced by HasExtension(), and isExtHandlingFromDiagsError().

bool clang::DiagnosticsEngine::getFatalsAsError ( ) const
inline

Definition at line 463 of file Diagnostic.h.

StringRef clang::DiagnosticsEngine::getFlagValue ( ) const
inline

Return the value associated with this diagnostic flag.

Definition at line 715 of file Diagnostic.h.

Referenced by printDiagnosticOptions().

bool clang::DiagnosticsEngine::getIgnoreAllWarnings ( ) const
inline

Definition at line 442 of file Diagnostic.h.

unsigned clang::DiagnosticsEngine::getNumWarnings ( ) const
inline

Definition at line 594 of file Diagnostic.h.

bool clang::DiagnosticsEngine::getPrintTemplateTree ( )
inline

Definition at line 485 of file Diagnostic.h.

bool clang::DiagnosticsEngine::getShowColors ( )
inline

Definition at line 490 of file Diagnostic.h.

OverloadsShown clang::DiagnosticsEngine::getShowOverloads ( ) const
inline
SourceManager& clang::DiagnosticsEngine::getSourceManager ( ) const
inline
bool clang::DiagnosticsEngine::getSuppressAllDiagnostics ( ) const
inline

Definition at line 475 of file Diagnostic.h.

Referenced by BuildCounterUpdate(), and clang::Sema::tryExprAsCall().

bool clang::DiagnosticsEngine::getSuppressSystemWarnings ( ) const
inline
unsigned clang::DiagnosticsEngine::getTemplateBacktraceLimit ( ) const
inline

Retrieve the maximum number of template instantiation notes to emit along with a given diagnostic.

Definition at line 422 of file Diagnostic.h.

Referenced by clang::Sema::PrintInstantiationStack().

bool clang::DiagnosticsEngine::getWarningsAsErrors ( ) const
inline

Definition at line 453 of file Diagnostic.h.

Referenced by checkDiagnosticMappings(), and isExtHandlingFromDiagsError().

bool clang::DiagnosticsEngine::hasAllExtensionsSilenced ( )
inline

Definition at line 531 of file Diagnostic.h.

bool clang::DiagnosticsEngine::hasErrorOccurred ( ) const
inline
bool clang::DiagnosticsEngine::hasFatalErrorOccurred ( ) const
inline

Definition at line 587 of file Diagnostic.h.

bool clang::DiagnosticsEngine::hasSourceManager ( ) const
inline
bool clang::DiagnosticsEngine::hasUncompilableErrorOccurred ( ) const
inline

Errors that actually prevent compilation, not those that are upgraded from a warning by -Werror.

Definition at line 584 of file Diagnostic.h.

Referenced by clang::PCHGenerator::HandleTranslationUnit(), clang::sema::AnalysisBasedWarnings::IssueWarnings(), and clang::ASTUnit::serialize().

bool clang::DiagnosticsEngine::hasUnrecoverableErrorOccurred ( ) const
inline

Determine whether any kind of unrecoverable error has occurred.

Definition at line 590 of file Diagnostic.h.

Referenced by clang::arcmt::TransformActions::hasReportedErrors().

void clang::DiagnosticsEngine::IncrementAllExtensionsSilenced ( )
inline

Counter bumped when an extension block is/ encountered.

When non-zero, all extension diagnostics are entirely silenced, no matter how they are mapped.

Definition at line 529 of file Diagnostic.h.

Referenced by clang::ExtensionRAIIObject::ExtensionRAIIObject().

bool clang::DiagnosticsEngine::isDiagnosticInFlight ( ) const
inline

Determine whethere there is already a diagnostic in flight.

Definition at line 685 of file Diagnostic.h.

bool clang::DiagnosticsEngine::isIgnored ( unsigned  DiagID,
SourceLocation  Loc 
) const
inline
bool clang::DiagnosticsEngine::isLastDiagnosticIgnored ( ) const
inline

Determine whether the previous diagnostic was ignored.

This can be used by clients that want to determine whether notes attached to a diagnostic will be suppressed.

Definition at line 514 of file Diagnostic.h.

References clang::DiagnosticIDs::Ignored.

Referenced by clang::Sema::DiagnoseAbstractType().

void clang::DiagnosticsEngine::notePriorDiagnosticFrom ( const DiagnosticsEngine Other)
inline

Note that the prior diagnostic was emitted by some other DiagnosticsEngine, and we may be attaching a note to that diagnostic.

Definition at line 632 of file Diagnostic.h.

Referenced by clang::ASTImporter::FromDiag(), and clang::ASTImporter::ToDiag().

bool clang::DiagnosticsEngine::ownsClient ( ) const
inline

Determine whether this DiagnosticsEngine object own its client.

Definition at line 373 of file Diagnostic.h.

Referenced by SetUpDiagnosticLog(), and SetupSerializedDiagnostics().

bool DiagnosticsEngine::popMappings ( SourceLocation  Loc)

Pops the current DiagMappings off the top of the stack, causing the new top of the stack to be the active mappings.

Returns
true if the pop happens, false if there is only one DiagMapping on the stack.

Definition at line 103 of file Diagnostic.cpp.

void DiagnosticsEngine::pushMappings ( SourceLocation  Loc)

Copies the current DiagMappings and pushes the new copy onto the top of the stack.

Definition at line 99 of file Diagnostic.cpp.

DiagnosticBuilder clang::DiagnosticsEngine::Report ( SourceLocation  Loc,
unsigned  DiagID 
)
inline

Issue the message to the client.

This actually returns an instance of DiagnosticBuilder which emits the diagnostics (through ProcessDiag) when it is destroyed.

Parameters
DiagIDA member of the diag::kind enum.
LocRepresents the source location associated with the diagnostic, which can be an invalid location if no position information is available.

Definition at line 1124 of file Diagnostic.h.

References DiagnosticBuilder.

Referenced by AddImplicitIncludePTH(), clang::ASTReader::ASTReader(), clang::AttachHeaderIncludeGen(), clang::FrontendAction::BeginSourceFile(), clang::GenerateModuleAction::BeginSourceFileAction(), clang::driver::Driver::BuildCompilation(), checkDiagnosticGroupMappings(), checkDiagnosticMappings(), checkHeaderSearchOptions(), checkLanguageOptions(), checkMSVCHeaderSearch(), checkPreprocessorOptions(), clang::CodeGen::CodeGenFunction::checkTargetFeatures(), checkTargetOptions(), clang::CompilerInstance::clearOutputFiles(), clang::CodeGen::CodeGenModule::CodeGenModule(), compileAndLoadModule(), compileModuleImpl(), clang::GeneratePCHAction::ComputeASTConsumerArguments(), clang::PTHManager::Create(), clang::DependencyFileGenerator::CreateAndAttachToPreprocessor(), clang::CodeGenAction::CreateASTConsumer(), clang::ento::createCheckerManager(), clang::CompilerInstance::createCodeCompletionConsumer(), clang::TestModuleFileExtension::createExtensionReader(), clang::CompilerInvocation::CreateFromArgs(), CreateFrontendBaseAction(), clang::CompilerInstance::createOutputFile(), clang::TargetInfo::CreateTargetInfo(), clang::createVFSFromCompilerInvocation(), DefineBuiltinMacro(), Diag(), clang::driver::Driver::Diag(), clang::FixItRewriter::Diag(), clang::Parser::Diag(), clang::Sema::Diag(), clang::Preprocessor::Diag(), clang::ASTReader::Diag(), clang::ModuleMap::diagnoseHeaderInclusion(), clang::CodeGen::CodeGenFunction::EmitAsmStmt(), clang::PartialDiagnostic::EmitToString(), EmitUnknownDiagWarning(), EnableCodeCompletion(), clang::CodeGen::CodeGenModule::Error(), clang::CodeGen::CodeGenModule::ErrorUnsupported(), clang::CodeGen::CGCXXABI::ErrorUnsupportedABI(), clang::CodeGenAction::ExecuteAction(), clang::ExecuteCompilerInvocation(), clang::TextDiagnosticBuffer::FlushDiagnostics(), clang::ASTImporter::FromDiag(), GenerateOptimizationRemarkRegex(), clang::tooling::getCC1Arguments(), getCodeModel(), clang::getLastArgIntValueImpl(), clang::ASTReader::getOriginalSourceFile(), InitializeFileRemapping(), clang::CompilerInstance::InitializeSourceManager(), InvalidPTH(), clang::CompilerInstance::loadModule(), clang::CompilerInstance::loadModuleFile(), maybeDiagnoseIDCharCompat(), clang::RecordDecl::mayInsertExtraPadding(), ParseAnalyzerArgs(), clang::driver::Driver::ParseArgStrings(), ParseCodeGenArgs(), parseDiagnosticLevelMask(), ParseDirective(), ParseFrontendArgs(), ParseLangArgs(), clang::ModuleMapParser::parseModuleMapFile(), ParsePreprocessorArgs(), parseSanitizerKinds(), ParseTargetArgs(), parseVisibility(), PrintExpected(), clang::Sema::PrintInstantiationStack(), PrintUnexpected(), clang::ProcessWarningOptions(), clang::arcmt::TransformActions::report(), Report(), reportDiag(), clang::arcmt::CapturedDiagList::reportDiagnostics(), clang::CodeGen::InstrProfStats::reportDiagnostics(), rewriteToNumericBoxedExpression(), selectBestPath(), setPGOInstrumentor(), SetUpDiagnosticLog(), clang::ASTImporter::ToDiag(), clang::ento::CheckerRegistry::validateCheckerOptions(), and clang::FixItRewriter::WriteFixedFiles().

DiagnosticBuilder clang::DiagnosticsEngine::Report ( unsigned  DiagID)
inline

Definition at line 1133 of file Diagnostic.h.

References Report().

void DiagnosticsEngine::Report ( const StoredDiagnostic storedDiag)
void DiagnosticsEngine::Reset ( )

Reset the state of the diagnostic object to its initial configuration.

Definition at line 115 of file Diagnostic.cpp.

References clang::DiagnosticIDs::Ignored.

Referenced by clang::FixItRecompile::BeginInvocation(), DiagnosticsEngine(), and clang::ASTUnit::Reparse().

void clang::DiagnosticsEngine::SetArgToStringFn ( ArgToStringFnTy  Fn,
void *  Cookie 
)
inline

Definition at line 625 of file Diagnostic.h.

Referenced by clang::ASTMergeAction::ExecuteAction().

void DiagnosticsEngine::setClient ( DiagnosticConsumer client,
bool  ShouldOwnClient = true 
)

Set the diagnostic client associated with this diagnostic object.

Parameters
ShouldOwnClienttrue if the diagnostic object should take ownership of client.

Definition at line 93 of file Diagnostic.cpp.

Referenced by clang::FixItRewriter::Diag(), DiagnosticsEngine(), clang::FixItRewriter::FixItRewriter(), SetUpDiagnosticLog(), SetupSerializedDiagnostics(), ~DiagnosticsEngine(), and clang::FixItRewriter::~FixItRewriter().

void clang::DiagnosticsEngine::setConstexprBacktraceLimit ( unsigned  Limit)
inline

Specify the maximum number of constexpr evaluation notes to emit along with a given diagnostic.

Definition at line 428 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void DiagnosticsEngine::SetDelayedDiagnostic ( unsigned  DiagID,
StringRef  Arg1 = "",
StringRef  Arg2 = "" 
)

Set the "delayed" diagnostic that will be emitted once the current diagnostic completes.

If a diagnostic is already in-flight but the front end must report a problem (e.g., with an inconsistent file system state), this routine sets a "delayed" diagnostic that will be emitted after the current diagnostic completes. This should only be used for fatal errors detected at inconvenient times. If emitting a delayed diagnostic causes a second delayed diagnostic to be introduced, that second delayed diagnostic will be ignored.

Parameters
DiagIDThe ID of the diagnostic being delayed.
Arg1A string argument that will be provided to the diagnostic. A copy of this string will be stored in the DiagnosticsEngine object itself.
Arg2A string argument that will be provided to the diagnostic. A copy of this string will be stored in the DiagnosticsEngine object itself.

Definition at line 141 of file Diagnostic.cpp.

bool DiagnosticsEngine::setDiagnosticGroupErrorAsFatal ( StringRef  Group,
bool  Enabled 
)

Set the error-as-fatal flag for the given diagnostic group.

This function always only operates on the current diagnostic state.

Returns
True if the given group is unknown, false otherwise.

Definition at line 295 of file Diagnostic.cpp.

References Diag(), clang::diag::Error, clang::diag::Fatal, clang::DiagnosticMapping::getSeverity(), clang::DiagnosticMapping::setNoErrorAsFatal(), clang::DiagnosticMapping::setSeverity(), setSeverityForGroup(), and clang::diag::WarningOrError.

Referenced by clang::ProcessWarningOptions().

bool DiagnosticsEngine::setDiagnosticGroupWarningAsError ( StringRef  Group,
bool  Enabled 
)

Set the warning-as-error flag for the given diagnostic group.

This function always only operates on the current diagnostic state.

Returns
True if the given group is unknown, false otherwise.

Definition at line 264 of file Diagnostic.cpp.

References Diag(), clang::diag::Error, clang::diag::Fatal, clang::DiagnosticMapping::getSeverity(), clang::DiagnosticMapping::setNoWarningAsError(), clang::DiagnosticMapping::setSeverity(), setSeverityForGroup(), clang::diag::Warning, and clang::diag::WarningOrError.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setElideType ( bool  Val = true)
inline

Set type eliding, to skip outputting same types occurring in template types.

Definition at line 479 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setEnableAllWarnings ( bool  Val)
inline

When set to true, any unmapped ignored warnings are no longer ignored.

If this and IgnoreAllWarnings are both set, then that one wins.

Definition at line 448 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setErrorLimit ( unsigned  Limit)
inline

Specify a limit for the number of errors we should emit before giving up.

Zero disables the limit.

Definition at line 412 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setErrorsAsFatal ( bool  Val)
inline

When set to true, any error reported is made a fatal error.

Definition at line 456 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setExtensionHandlingBehavior ( diag::Severity  H)
inline

Controls whether otherwise-unmapped extension diagnostics are mapped onto ignore/warning/error.

This corresponds to the GCC -pedantic and -pedantic-errors option.

Definition at line 522 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setFatalsAsError ( bool  Val)
inline

When set to true, any fatal error reported is made an error.

This setting takes precedence over the setErrorsAsFatal setting above.

Definition at line 462 of file Diagnostic.h.

void clang::DiagnosticsEngine::setIgnoreAllWarnings ( bool  Val)
inline
void clang::DiagnosticsEngine::setLastDiagnosticIgnored ( )
inline

Pretend that the last diagnostic issued was ignored, so any subsequent notes will be suppressed.

This can be used by clients who suppress diagnostics themselves.

Definition at line 505 of file Diagnostic.h.

References clang::DiagnosticIDs::Fatal, and clang::DiagnosticIDs::Ignored.

Referenced by clang::Sema::EmitCurrentDiagnostic().

void clang::DiagnosticsEngine::setNumWarnings ( unsigned  NumWarnings)
inline

Definition at line 596 of file Diagnostic.h.

Referenced by clang::ASTUnit::Reparse().

void clang::DiagnosticsEngine::setPrintTemplateTree ( bool  Val = false)
inline

Set tree printing, to outputting the template difference in a tree format.

Definition at line 484 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void DiagnosticsEngine::setSeverity ( diag::kind  Diag,
diag::Severity  Map,
SourceLocation  Loc 
)

This allows the client to specify that certain warnings are ignored.

Notes can never be mapped, errors can only be mapped to fatal, and WARNINGs and EXTENSIONs can be mapped arbitrarily.

Parameters
LocThe source location that this change of diagnostic state should take affect. It can be null if we are setting the latest state.

Definition at line 181 of file Diagnostic.cpp.

References clang::diag::DIAG_UPPER_LIMIT, E, clang::diag::Error, clang::diag::Fatal, clang::DiagnosticMapping::getSeverity(), I, clang::FullSourceLoc::isBeforeInTranslationUnitThan(), clang::SourceLocation::isInvalid(), clang::SourceLocation::isValid(), and clang::diag::Warning.

Referenced by setSeverityForAll(), and setSeverityForGroup().

void DiagnosticsEngine::setSeverityForAll ( diag::Flavor  Flavor,
diag::Severity  Map,
SourceLocation  Loc = SourceLocation() 
)

Add the specified mapping to all diagnostics of the specified flavor.

Mainly to be used by -Wno-everything to disable all warnings but allow subsequent -W options to enable specific warnings.

Definition at line 325 of file Diagnostic.cpp.

References Diag(), and setSeverity().

Referenced by clang::ProcessWarningOptions().

bool DiagnosticsEngine::setSeverityForGroup ( diag::Flavor  Flavor,
StringRef  Group,
diag::Severity  Map,
SourceLocation  Loc = SourceLocation() 
)

Change an entire diagnostic group (e.g.

"unknown-pragmas") to have the specified mapping.

Returns
true (and ignores the request) if "Group" was unknown, false otherwise.
Parameters
FlavorThe flavor of group to affect. -Rfoo does not affect the state of the -Wfoo group and vice versa.
LocThe source location that this change of diagnostic state should take affect. It can be null if we are setting the state from command-line.

Definition at line 249 of file Diagnostic.cpp.

References Diag(), and setSeverity().

Referenced by clang::ProcessWarningOptions(), setDiagnosticGroupErrorAsFatal(), and setDiagnosticGroupWarningAsError().

void clang::DiagnosticsEngine::setShowColors ( bool  Val = false)
inline

Set color printing, so the type diffing will inject color markers into the output.

Definition at line 489 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setShowOverloads ( OverloadsShown  Val)
inline

Specify which overload candidates to show when overload resolution fails.

By default, we show all candidates.

Definition at line 496 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setSourceManager ( SourceManager SrcMgr)
inline

Definition at line 384 of file Diagnostic.h.

Referenced by clang::SourceManager::SourceManager().

void clang::DiagnosticsEngine::setSuppressAllDiagnostics ( bool  Val = true)
inline

Suppress all diagnostics, to silence the front end when we know that we don't want any more diagnostics to be passed along to the client.

Definition at line 472 of file Diagnostic.h.

Referenced by BuildCounterUpdate(), clang::Preprocessor::setCodeCompletionReached(), and clang::Sema::tryExprAsCall().

void clang::DiagnosticsEngine::setSuppressSystemWarnings ( bool  Val)
inline

When set to true mask warnings that come from system headers.

Definition at line 466 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setTemplateBacktraceLimit ( unsigned  Limit)
inline

Specify the maximum number of template instantiation notes to emit along with a given diagnostic.

Definition at line 416 of file Diagnostic.h.

Referenced by clang::ProcessWarningOptions().

void clang::DiagnosticsEngine::setWarningsAsErrors ( bool  Val)
inline

When set to true, any warnings reported are issued as errors.

Definition at line 452 of file Diagnostic.h.

Referenced by clang::ento::CreateAnalysisConsumer(), and clang::ProcessWarningOptions().

std::unique_ptr<DiagnosticConsumer> clang::DiagnosticsEngine::takeClient ( )
inline

Return the current diagnostic client along with ownership of that client.

Definition at line 377 of file Diagnostic.h.

Referenced by clang::FixItRewriter::FixItRewriter(), SetUpDiagnosticLog(), SetupSerializedDiagnostics(), and clang::VerifyDiagnosticConsumer::~VerifyDiagnosticConsumer().

Friends And Related Function Documentation

friend class ASTReader
friend

Definition at line 822 of file Diagnostic.h.

friend class ASTWriter
friend

Definition at line 823 of file Diagnostic.h.

friend class Diagnostic
friend

Definition at line 729 of file Diagnostic.h.

friend class DiagnosticBuilder
friend

Definition at line 728 of file Diagnostic.h.

Referenced by Report().

friend class DiagnosticErrorTrap
friend

Definition at line 731 of file Diagnostic.h.

friend class DiagnosticIDs
friend

Definition at line 727 of file Diagnostic.h.

friend class PartialDiagnostic
friend

Definition at line 730 of file Diagnostic.h.

friend class Sema
friend

Definition at line 809 of file Diagnostic.h.


The documentation for this class was generated from the following files: