clang-tools 19.0.0git
Public Types | Public Member Functions | Protected Attributes | List of all members
clang::clangd::GlobalCompilationDatabase Class Referenceabstract

Provides compilation arguments used for parsing C and C++ files. More...

#include <GlobalCompilationDatabase.h>

Inheritance diagram for clang::clangd::GlobalCompilationDatabase:
Inheritance graph
[legend]

Public Types

using CommandChanged = Event< std::vector< std::string > >
 

Public Member Functions

virtual ~GlobalCompilationDatabase ()=default
 
virtual std::optional< tooling::CompileCommand > getCompileCommand (PathRef File) const =0
 If there are any known-good commands for building this file, returns one.
 
virtual std::optional< ProjectInfogetProjectInfo (PathRef File) const
 Finds the closest project to File.
 
virtual tooling::CompileCommand getFallbackCommand (PathRef File) const
 Makes a guess at how to build a file.
 
virtual bool blockUntilIdle (Deadline D) const
 If the CDB does any asynchronous work, wait for it to complete.
 
CommandChanged::Subscription watch (CommandChanged::Listener L) const
 The callback is notified when files may have new compile commands.
 

Protected Attributes

CommandChanged OnCommandChanged
 

Detailed Description

Provides compilation arguments used for parsing C and C++ files.

Definition at line 35 of file GlobalCompilationDatabase.h.

Member Typedef Documentation

◆ CommandChanged

Definition at line 57 of file GlobalCompilationDatabase.h.

Constructor & Destructor Documentation

◆ ~GlobalCompilationDatabase()

virtual clang::clangd::GlobalCompilationDatabase::~GlobalCompilationDatabase ( )
virtualdefault

Member Function Documentation

◆ blockUntilIdle()

virtual bool clang::clangd::GlobalCompilationDatabase::blockUntilIdle ( Deadline  D) const
inlinevirtual

If the CDB does any asynchronous work, wait for it to complete.

For use in tests.

Reimplemented in clang::clangd::DelegatingCDB, and clang::clangd::DirectoryBasedGlobalCompilationDatabase.

Definition at line 55 of file GlobalCompilationDatabase.h.

Referenced by clang::clangd::DelegatingCDB::blockUntilIdle().

◆ getCompileCommand()

virtual std::optional< tooling::CompileCommand > clang::clangd::GlobalCompilationDatabase::getCompileCommand ( PathRef  File) const
pure virtual

◆ getFallbackCommand()

tooling::CompileCommand clang::clangd::GlobalCompilationDatabase::getFallbackCommand ( PathRef  File) const
virtual

Makes a guess at how to build a file.

The default implementation just runs clang on the file. Clangd should treat the results as unreliable.

Reimplemented in clang::clangd::DelegatingCDB, and clang::clangd::OverlayCDB.

Definition at line 55 of file GlobalCompilationDatabase.cpp.

References clang::clangd::File.

Referenced by clang::clangd::DelegatingCDB::getFallbackCommand().

◆ getProjectInfo()

virtual std::optional< ProjectInfo > clang::clangd::GlobalCompilationDatabase::getProjectInfo ( PathRef  File) const
inlinevirtual

◆ watch()

CommandChanged::Subscription clang::clangd::GlobalCompilationDatabase::watch ( CommandChanged::Listener  L) const
inline

The callback is notified when files may have new compile commands.

The argument is a list of full file paths.

Definition at line 60 of file GlobalCompilationDatabase.h.

References clang::clangd::Event< T >::observe(), and OnCommandChanged.

Member Data Documentation

◆ OnCommandChanged

CommandChanged clang::clangd::GlobalCompilationDatabase::OnCommandChanged
mutableprotected

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