BugReporter is a utility class for generating PathDiagnostics for analysis. More...

#include "clang/StaticAnalyzer/Core/BugReporter/BugReporter.h"

Inheritance diagram for clang::ento::BugReporter:

Public Types
using	EQClasses_iterator = llvm::FoldingSet< BugReportEquivClass >::iterator
	Iterator over the set of BugReports tracked by the BugReporter.

Public Member Functions
	BugReporter (BugReporterData &d)

virtual	~BugReporter ()

void	FlushReports ()
	Generate and flush diagnostics for all bug reports.

ArrayRef< PathDiagnosticConsumer * >	getPathDiagnosticConsumers ()

llvm::iterator_range< EQClasses_iterator >	equivalenceClasses ()

ASTContext &	getContext ()

const SourceManager &	getSourceManager ()

const AnalyzerOptions &	getAnalyzerOptions ()

Preprocessor &	getPreprocessor ()

const Decl *	getAnalysisEntryPoint () const
	Get the top-level entry point for the issue to be reported.

void	setAnalysisEntryPoint (const Decl *EntryPoint)

virtual void	emitReport (std::unique_ptr< BugReport > R)
	Add the given report to the set of reports tracked by BugReporter.

void	EmitBasicReport (const Decl DeclWithIssue, const CheckerBase Checker, StringRef BugName, StringRef BugCategory, StringRef BugStr, PathDiagnosticLocation Loc, ArrayRef< SourceRange > Ranges=std::nullopt, ArrayRef< FixItHint > Fixits=std::nullopt)

void	EmitBasicReport (const Decl *DeclWithIssue, CheckerNameRef CheckerName, StringRef BugName, StringRef BugCategory, StringRef BugStr, PathDiagnosticLocation Loc, ArrayRef< SourceRange > Ranges=std::nullopt, ArrayRef< FixItHint > Fixits=std::nullopt)

Protected Member Functions
virtual std::unique_ptr< DiagnosticForConsumerMapTy >	generateDiagnosticForConsumerMap (BugReport exampleReport, ArrayRef< PathDiagnosticConsumer > consumers, ArrayRef< BugReport * > bugReports)
	Generate the diagnostics for the given bug report.

Detailed Description

BugReporter is a utility class for generating PathDiagnostics for analysis.

It collects the BugReports and BugTypes and knows how to generate and flush the corresponding diagnostics.

The base class is used for generating path-insensitive

Definition at line 585 of file BugReporter.h.

Member Typedef Documentation

◆ EQClasses_iterator

using clang::ento::BugReporter::EQClasses_iterator = llvm::FoldingSet<BugReportEquivClass>::iterator

Iterator over the set of BugReports tracked by the BugReporter.

Definition at line 616 of file BugReporter.h.

Constructor & Destructor Documentation

◆ BugReporter()

BugReporter::BugReporter ( BugReporterData & d )

Definition at line 2475 of file BugReporter.cpp.

◆ ~BugReporter()

BugReporter::~BugReporter ( )

virtual

Definition at line 2478 of file BugReporter.cpp.

Member Function Documentation

◆ EmitBasicReport() [1/2]

void BugReporter::EmitBasicReport	(	const Decl *	DeclWithIssue,
		CheckerNameRef	CheckerName,
		StringRef	BugName,
		StringRef	BugCategory,
		StringRef	BugStr,
		PathDiagnosticLocation	Loc,
		ArrayRef< SourceRange >	Ranges = `std::nullopt`,
		ArrayRef< FixItHint >	Fixits = `std::nullopt`
	)

Definition at line 3348 of file BugReporter.cpp.

References clang::ento::BugReport::addFixItHint(), clang::ento::BugReport::addRange(), and emitReport().

◆ EmitBasicReport() [2/2]

void BugReporter::EmitBasicReport	(	const Decl *	DeclWithIssue,
		const CheckerBase *	Checker,
		StringRef	BugName,
		StringRef	BugCategory,
		StringRef	BugStr,
		PathDiagnosticLocation	Loc,
		ArrayRef< SourceRange >	Ranges = `std::nullopt`,
		ArrayRef< FixItHint >	Fixits = `std::nullopt`
	)

Definition at line 3338 of file BugReporter.cpp.

References Category, EmitBasicReport(), and clang::ento::CheckerBase::getCheckerName().

Referenced by checkObjCUnusedIvar(), CompareReturnTypes(), EmitBasicReport(), and emitDiagnostics().

◆ emitReport()

void BugReporter::emitReport ( std::unique_ptr< BugReport > R )

virtual

Add the given report to the set of reports tracked by BugReporter.

The reports are usually generated by the checkers. Further, they are folded based on the profile value, which is done to coalesce similar reports.

Reimplemented in clang::ento::PathSensitiveBugReporter.

Definition at line 2907 of file BugReporter.cpp.

References clang::ento::BugSuppression::isSuppressed().

Referenced by EmitBasicReport(), clang::ento::CheckerContext::emitReport(), clang::ento::PathSensitiveBugReporter::emitReport(), clang::ento::mpi::MPIBugReporter::reportDoubleNonblocking(), clang::ento::mpi::MPIBugReporter::reportMissingWait(), and clang::ento::mpi::MPIBugReporter::reportUnmatchedWait().

◆ equivalenceClasses()

llvm::iterator_range< EQClasses_iterator > clang::ento::BugReporter::equivalenceClasses ( )

inline

Definition at line 617 of file BugReporter.h.

Referenced by clang::ento::ExprEngine::DumpGraph(), and llvm::DOTGraphTraits< ExplodedGraph * >::nodeHasBugReport().

◆ FlushReports()

void BugReporter::FlushReports ( )

Generate and flush diagnostics for all bug reports.

Definition at line 2488 of file BugReporter.cpp.

◆ generateDiagnosticForConsumerMap()

std::unique_ptr< DiagnosticForConsumerMapTy > BugReporter::generateDiagnosticForConsumerMap	(	BugReport *	exampleReport,
		ArrayRef< PathDiagnosticConsumer * >	consumers,
		ArrayRef< BugReport * >	bugReports
	)