clang API Documentation

Public Types | Public Member Functions | Public Attributes
clang::ento::PathDiagnostic Class Reference

#include <PathDiagnostic.h>

Inheritance diagram for clang::ento::PathDiagnostic:
Inheritance graph
[legend]
Collaboration diagram for clang::ento::PathDiagnostic:
Collaboration graph
[legend]

List of all members.

Public Types

typedef std::deque
< std::string >
::const_iterator 
meta_iterator

Public Member Functions

 PathDiagnostic (StringRef CheckName, const Decl *DeclWithIssue, StringRef bugtype, StringRef verboseDesc, StringRef shortDesc, StringRef category, PathDiagnosticLocation LocationToUnique, const Decl *DeclToUnique)
 ~PathDiagnostic ()
PathPiecesgetActivePath ()
PathPiecesgetMutablePieces ()
 Return a mutable version of 'path'.
unsigned full_size ()
 Return the unrolled size of the path.
void pushActivePath (PathPieces *p)
void popActivePath ()
bool isWithinCall () const
void setEndOfPath (std::unique_ptr< PathDiagnosticPiece > EndPiece)
void appendToDesc (StringRef S)
void resetPath ()
void resetDiagnosticLocationToMainFile ()
 If the last piece of the report point to the header file, resets the location of the report to be the last location in the main source file.
StringRef getVerboseDescription () const
StringRef getShortDescription () const
StringRef getCheckName () const
StringRef getBugType () const
StringRef getCategory () const
const DeclgetDeclWithIssue () const
meta_iterator meta_begin () const
meta_iterator meta_end () const
void addMeta (StringRef s)
PathDiagnosticLocation getLocation () const
PathDiagnosticLocation getUniqueingLoc () const
 Get the location on which the report should be uniqued.
const DeclgetUniqueingDecl () const
 Get the declaration containing the uniqueing location.
void flattenLocations ()
void Profile (llvm::FoldingSetNodeID &ID) const
void FullProfile (llvm::FoldingSetNodeID &ID) const

Public Attributes

const PathPiecespath

Detailed Description

PathDiagnostic - PathDiagnostic objects represent a single path-sensitive diagnostic. It represents an ordered-collection of PathDiagnosticPieces, each which represent the pieces of the path.

Definition at line 713 of file PathDiagnostic.h.


Member Typedef Documentation

typedef std::deque<std::string>::const_iterator clang::ento::PathDiagnostic::meta_iterator

Definition at line 802 of file PathDiagnostic.h.


Constructor & Destructor Documentation

PathDiagnostic::PathDiagnostic ( StringRef  CheckName,
const Decl DeclWithIssue,
StringRef  bugtype,
StringRef  verboseDesc,
StringRef  shortDesc,
StringRef  category,
PathDiagnosticLocation  LocationToUnique,
const Decl DeclToUnique 
)

Definition at line 110 of file PathDiagnostic.cpp.

Definition at line 108 of file PathDiagnostic.cpp.


Member Function Documentation

void clang::ento::PathDiagnostic::addMeta ( StringRef  s) [inline]

Definition at line 805 of file PathDiagnostic.h.

void clang::ento::PathDiagnostic::appendToDesc ( StringRef  S) [inline]

Definition at line 772 of file PathDiagnostic.h.

Referenced by resetDiagnosticLocationToMainFile().

Definition at line 822 of file PathDiagnostic.h.

Return the unrolled size of the path.

Definition at line 1049 of file PathDiagnostic.cpp.

References compute_path_size().

void PathDiagnostic::FullProfile ( llvm::FoldingSetNodeID &  ID) const

Profiles the diagnostic, including its path.

Two diagnostics with the same issue along different paths will generate different profiles.

Definition at line 1112 of file PathDiagnostic.cpp.

Return the path currently used by builders for constructing the PathDiagnostic.

Definition at line 746 of file PathDiagnostic.h.

Referenced by GenerateAlternateExtensivePathDiagnostic(), GenerateExtensivePathDiagnostic(), GenerateMinimalPathDiagnostic(), and setEndOfPath().

StringRef clang::ento::PathDiagnostic::getBugType ( ) const [inline]

Definition at line 794 of file PathDiagnostic.h.

Referenced by compare().

StringRef clang::ento::PathDiagnostic::getCategory ( ) const [inline]

Definition at line 795 of file PathDiagnostic.h.

Referenced by compare().

StringRef clang::ento::PathDiagnostic::getCheckName ( ) const [inline]

Definition at line 793 of file PathDiagnostic.h.

Return the semantic context where an issue occurred. If the issue occurs along a path, this represents the "central" area where the bug manifests.

Definition at line 800 of file PathDiagnostic.h.

Referenced by compare().

Definition at line 807 of file PathDiagnostic.h.

Referenced by compare(), and GenerateAlternateExtensivePathDiagnostic().

Return a mutable version of 'path'.

Definition at line 753 of file PathDiagnostic.h.

Referenced by GenerateMinimalPathDiagnostic(), and clang::ento::GRBugReporter::generatePathDiagnostic().

Definition at line 790 of file PathDiagnostic.h.

Referenced by compare().

Get the declaration containing the uniqueing location.

Definition at line 818 of file PathDiagnostic.h.

Get the location on which the report should be uniqued.

Definition at line 813 of file PathDiagnostic.h.

Definition at line 789 of file PathDiagnostic.h.

Referenced by compare().

Definition at line 803 of file PathDiagnostic.h.

Referenced by compare().

Definition at line 804 of file PathDiagnostic.h.

Referenced by compare().

void PathDiagnostic::Profile ( llvm::FoldingSetNodeID &  ID) const

Profiles the diagnostic, independent of the path it references.

This can be used to merge diagnostics that refer to the same issue along different paths.

Definition at line 1105 of file PathDiagnostic.cpp.

If the last piece of the report point to the header file, resets the location of the report to be the last location in the main source file.

Definition at line 156 of file PathDiagnostic.cpp.

References appendToDesc(), clang::NamedDecl::getDeclName(), getFirstStackedCallToHeaderFile(), clang::ento::PathDiagnosticPiece::getLocation(), clang::ento::PathDiagnosticLocation::getManager(), and path.

void clang::ento::PathDiagnostic::setEndOfPath ( std::unique_ptr< PathDiagnosticPiece EndPiece) [inline]

Definition at line 765 of file PathDiagnostic.h.

References getActivePath().

Referenced by clang::ento::GRBugReporter::generatePathDiagnostic().


Member Data Documentation


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