Abstract interface for callback invocations by the ASTReader. More...

#include "clang/Serialization/ASTReader.h"

Inheritance diagram for clang::ASTReaderListener:

[legend]

Public Member Functions
virtual	~ASTReaderListener ()

virtual bool	ReadFullVersionInformation (StringRef FullVersion)
	Receives the full Clang version information.

virtual void	ReadModuleName (StringRef ModuleName)

virtual void	ReadModuleMapFile (StringRef ModuleMapPath)

virtual bool	ReadLanguageOptions (const LangOptions &LangOpts, bool Complain, bool AllowCompatibleDifferences)
	Receives the language options.

virtual bool	ReadTargetOptions (const TargetOptions &TargetOpts, bool Complain, bool AllowCompatibleDifferences)
	Receives the target options.

virtual bool	ReadDiagnosticOptions (IntrusiveRefCntPtr< DiagnosticOptions > DiagOpts, bool Complain)
	Receives the diagnostic options.

virtual bool	ReadFileSystemOptions (const FileSystemOptions &FSOpts, bool Complain)
	Receives the file system options.

virtual bool	ReadHeaderSearchOptions (const HeaderSearchOptions &HSOpts, StringRef SpecificModuleCachePath, bool Complain)
	Receives the header search options.

virtual bool	ReadHeaderSearchPaths (const HeaderSearchOptions &HSOpts, bool Complain)
	Receives the header search paths.

virtual bool	ReadPreprocessorOptions (const PreprocessorOptions &PPOpts, bool Complain, std::string &SuggestedPredefines)
	Receives the preprocessor options.

virtual void	ReadCounter (const serialization::ModuleFile &M, unsigned Value)
	Receives COUNTER value.

virtual void	visitModuleFile (StringRef Filename, serialization::ModuleKind Kind)
	This is called for each AST file loaded.

virtual bool	needsInputFileVisitation ()
	Returns true if this `ASTReaderListener` wants to receive the input files of the AST file via `visitInputFile`, false otherwise.

virtual bool	needsSystemInputFileVisitation ()
	Returns true if this `ASTReaderListener` wants to receive the system input files of the AST file via `visitInputFile`, false otherwise.

virtual bool	visitInputFile (StringRef Filename, bool isSystem, bool isOverridden, bool isExplicitModule)
	if `needsInputFileVisitation` returns true, this is called for each non-system input file of the AST File.

virtual bool	needsImportVisitation () const
	Returns true if this `ASTReaderListener` wants to receive the imports of the AST file via `visitImport`, false otherwise.

virtual void	visitImport (StringRef ModuleName, StringRef Filename)
	If needsImportVisitation returns `true`, this is called for each AST file imported by this AST file.

virtual void	readModuleFileExtension (const ModuleFileExtensionMetadata &Metadata)
	Indicates that a particular module file extension has been read.

Detailed Description

Abstract interface for callback invocations by the ASTReader.

While reading an AST file, the ASTReader will call the methods of the listener to pass on specific information. Some of the listener methods can return true to indicate to the ASTReader that the information (and consequently the AST file) is invalid.

Definition at line 113 of file ASTReader.h.

Constructor & Destructor Documentation

◆ ~ASTReaderListener()

ASTReaderListener::~ASTReaderListener ( )

virtualdefault

Member Function Documentation

◆ needsImportVisitation()

virtual bool clang::ASTReaderListener::needsImportVisitation ( ) const

inlinevirtual

Returns true if this ASTReaderListener wants to receive the imports of the AST file via visitImport, false otherwise.

Definition at line 236 of file ASTReader.h.

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ needsInputFileVisitation()

virtual bool clang::ASTReaderListener::needsInputFileVisitation ( )

inlinevirtual

Returns true if this ASTReaderListener wants to receive the input files of the AST file via visitInputFile, false otherwise.

Reimplemented in clang::ChainedASTReaderListener.

Definition at line 217 of file ASTReader.h.

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ needsSystemInputFileVisitation()

virtual bool clang::ASTReaderListener::needsSystemInputFileVisitation ( )

inlinevirtual

Returns true if this ASTReaderListener wants to receive the system input files of the AST file via visitInputFile, false otherwise.

Reimplemented in clang::ChainedASTReaderListener.

Definition at line 221 of file ASTReader.h.

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ ReadCounter()

virtual void clang::ASTReaderListener::ReadCounter	(	const serialization::ModuleFile &	M,
		unsigned	Value
	)

inlinevirtual

Receives COUNTER value.

Reimplemented in clang::ChainedASTReaderListener, and clang::PCHValidator.

Definition at line 208 of file ASTReader.h.

◆ ReadDiagnosticOptions()

virtual bool clang::ASTReaderListener::ReadDiagnosticOptions	(	IntrusiveRefCntPtr< DiagnosticOptions >	DiagOpts,
		bool	Complain
	)

inlinevirtual

Receives the diagnostic options.

Returns: true to indicate the diagnostic options are invalid, or false otherwise.

Reimplemented in clang::ChainedASTReaderListener, and clang::PCHValidator.

Definition at line 151 of file ASTReader.h.

◆ ReadFileSystemOptions()

virtual bool clang::ASTReaderListener::ReadFileSystemOptions	(	const FileSystemOptions &	FSOpts,
		bool	Complain
	)

inlinevirtual

Receives the file system options.

Returns: true to indicate the file system options are invalid, or false otherwise.

Reimplemented in clang::ChainedASTReaderListener.

Definition at line 160 of file ASTReader.h.

◆ ReadFullVersionInformation()

virtual bool clang::ASTReaderListener::ReadFullVersionInformation ( StringRef FullVersion )

inlinevirtual

Receives the full Clang version information.

Returns: true to indicate that the version is invalid. Subclasses should generally defer to this implementation.

Reimplemented in clang::ChainedASTReaderListener.

Definition at line 121 of file ASTReader.h.

References clang::getClangFullRepositoryVersion().

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ ReadHeaderSearchOptions()

virtual bool clang::ASTReaderListener::ReadHeaderSearchOptions	(	const HeaderSearchOptions &	HSOpts,
		StringRef	SpecificModuleCachePath,
		bool	Complain
	)

inlinevirtual

Receives the header search options.

Parameters

HSOpts The read header search options. The following fields are missing and are reported in ReadHeaderSearchPaths(): UserEntries, SystemHeaderPrefixes, VFSOverlayFiles.

Returns: true to indicate the header search options are invalid, or false otherwise.

Reimplemented in clang::ChainedASTReaderListener, and clang::PCHValidator.

Definition at line 173 of file ASTReader.h.

◆ ReadHeaderSearchPaths()

virtual bool clang::ASTReaderListener::ReadHeaderSearchPaths	(	const HeaderSearchOptions &	HSOpts,
		bool	Complain
	)

inlinevirtual

Receives the header search paths.

Parameters

HSOpts The read header search paths. Only the following fields are initialized: UserEntries, SystemHeaderPrefixes, VFSOverlayFiles. The rest is reported in ReadHeaderSearchOptions().

Returns: true to indicate the header search paths are invalid, or false otherwise.

Definition at line 188 of file ASTReader.h.

◆ ReadLanguageOptions()

virtual bool clang::ASTReaderListener::ReadLanguageOptions	(	const LangOptions &	LangOpts,
		bool	Complain,
		bool	AllowCompatibleDifferences
	)

inlinevirtual

Receives the language options.

Returns: true to indicate the options are invalid or false otherwise.

Reimplemented in clang::ChainedASTReaderListener, and clang::PCHValidator.

Definition at line 131 of file ASTReader.h.

◆ readModuleFileExtension()

virtual void clang::ASTReaderListener::readModuleFileExtension ( const ModuleFileExtensionMetadata & Metadata )

inlinevirtual

Indicates that a particular module file extension has been read.

Reimplemented in clang::ChainedASTReaderListener.

Definition at line 243 of file ASTReader.h.

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ ReadModuleMapFile()

virtual void clang::ASTReaderListener::ReadModuleMapFile ( StringRef ModuleMapPath )

inlinevirtual

Reimplemented in clang::ChainedASTReaderListener.

Definition at line 126 of file ASTReader.h.

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ ReadModuleName()

virtual void clang::ASTReaderListener::ReadModuleName ( StringRef ModuleName )

inlinevirtual

Reimplemented in clang::ChainedASTReaderListener.

Definition at line 125 of file ASTReader.h.

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ ReadPreprocessorOptions()

virtual bool clang::ASTReaderListener::ReadPreprocessorOptions	(	const PreprocessorOptions &	PPOpts,
		bool	Complain,
		std::string &	SuggestedPredefines
	)

inlinevirtual

Receives the preprocessor options.

Parameters

SuggestedPredefines Can be filled in with the set of predefines that are suggested by the preprocessor options. Typically only used when loading a precompiled header.

Returns: true to indicate the preprocessor options are invalid, or false otherwise.

Reimplemented in clang::ChainedASTReaderListener, clang::PCHValidator, and clang::SimpleASTReaderListener.

Definition at line 201 of file ASTReader.h.

◆ ReadTargetOptions()

virtual bool clang::ASTReaderListener::ReadTargetOptions	(	const TargetOptions &	TargetOpts,
		bool	Complain,
		bool	AllowCompatibleDifferences
	)

inlinevirtual

Receives the target options.

Returns: true to indicate the target options are invalid, or false otherwise.

Reimplemented in clang::ChainedASTReaderListener, and clang::PCHValidator.

Definition at line 141 of file ASTReader.h.

◆ visitImport()

virtual void clang::ASTReaderListener::visitImport	(	StringRef	ModuleName,
		StringRef	Filename
	)

inlinevirtual

If needsImportVisitation returns true, this is called for each AST file imported by this AST file.

Definition at line 240 of file ASTReader.h.

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ visitInputFile()

virtual bool clang::ASTReaderListener::visitInputFile	(	StringRef	Filename,
		bool	isSystem,
		bool	isOverridden,
		bool	isExplicitModule
	)

inlinevirtual

if needsInputFileVisitation returns true, this is called for each non-system input file of the AST File.

If needsSystemInputFileVisitation is true, then it is called for all system input files as well.

Returns: true to continue receiving the next input file, false to stop.

Reimplemented in clang::ChainedASTReaderListener.

Definition at line 229 of file ASTReader.h.

Referenced by clang::ASTReader::readASTFileControlBlock().

◆ visitModuleFile()

virtual void clang::ASTReaderListener::visitModuleFile	(	StringRef	Filename,
		serialization::ModuleKind	Kind
	)

inlinevirtual

This is called for each AST file loaded.

Reimplemented in clang::ChainedASTReaderListener, and clang::RewriteIncludesAction::RewriteImportsListener.

Definition at line 212 of file ASTReader.h.

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

include/clang/Serialization/ASTReader.h
lib/Serialization/ASTReader.cpp

Public Member Functions

Detailed Description

Constructor & Destructor Documentation

◆ ~ASTReaderListener()

Member Function Documentation

◆ needsImportVisitation()

◆ needsInputFileVisitation()

◆ needsSystemInputFileVisitation()

◆ ReadCounter()

◆ ReadDiagnosticOptions()

◆ ReadFileSystemOptions()

◆ ReadFullVersionInformation()

◆ ReadHeaderSearchOptions()

◆ ReadHeaderSearchPaths()

◆ ReadLanguageOptions()

◆ readModuleFileExtension()

◆ ReadModuleMapFile()

◆ ReadModuleName()

◆ ReadPreprocessorOptions()

◆ ReadTargetOptions()

◆ visitImport()

◆ visitInputFile()

◆ visitModuleFile()