clang 20.0.0git
IndexingAction.h
Go to the documentation of this file.
1//===--- IndexingAction.h - Frontend index action ---------------*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8
9#ifndef LLVM_CLANG_INDEX_INDEXINGACTION_H
10#define LLVM_CLANG_INDEX_INDEXINGACTION_H
11
13#include "clang/Basic/LLVM.h"
17#include "llvm/ADT/ArrayRef.h"
18#include <memory>
19
20namespace clang {
21 class ASTContext;
22 class ASTConsumer;
23 class ASTReader;
24 class ASTUnit;
25 class Decl;
26 class FrontendAction;
27
28namespace serialization {
29 class ModuleFile;
30}
31
32namespace index {
33class IndexDataConsumer;
34
35/// Creates an ASTConsumer that indexes all symbols (macros and AST decls).
36std::unique_ptr<ASTConsumer>
37createIndexingASTConsumer(std::shared_ptr<IndexDataConsumer> DataConsumer,
38 const IndexingOptions &Opts,
39 std::shared_ptr<Preprocessor> PP);
40
41std::unique_ptr<ASTConsumer> createIndexingASTConsumer(
42 std::shared_ptr<IndexDataConsumer> DataConsumer,
43 const IndexingOptions &Opts, std::shared_ptr<Preprocessor> PP,
44 // Prefer to set Opts.ShouldTraverseDecl and use the above overload.
45 // This version is only needed if used to *track* function body parsing.
46 std::function<bool(const Decl *)> ShouldSkipFunctionBody);
47
48/// Creates a frontend action that indexes all symbols (macros and AST decls).
49std::unique_ptr<FrontendAction>
50createIndexingAction(std::shared_ptr<IndexDataConsumer> DataConsumer,
51 const IndexingOptions &Opts);
52
53/// Recursively indexes all decls in the AST.
54void indexASTUnit(ASTUnit &Unit, IndexDataConsumer &DataConsumer,
55 IndexingOptions Opts);
56
57/// Recursively indexes \p Decls.
58void indexTopLevelDecls(ASTContext &Ctx, Preprocessor &PP,
59 ArrayRef<const Decl *> Decls,
60 IndexDataConsumer &DataConsumer, IndexingOptions Opts);
61
62/// Creates a PPCallbacks that indexes macros and feeds macros to \p Consumer.
63/// The caller is responsible for calling `Consumer.setPreprocessor()`.
64std::unique_ptr<PPCallbacks> indexMacrosCallback(IndexDataConsumer &Consumer,
65 IndexingOptions Opts);
66
67/// Recursively indexes all top-level decls in the module.
68void indexModuleFile(serialization::ModuleFile &Mod, ASTReader &Reader,
69 IndexDataConsumer &DataConsumer, IndexingOptions Opts);
70
71} // namespace index
72} // namespace clang
73
74#endif
Forward-declares and imports various common LLVM datatypes that clang wants to use unqualified.
Defines the PPCallbacks interface.
Defines the clang::Preprocessor interface.
@ Decl
The l-value was an access to a declared entity or something equivalently strong, like the address of ...
std::unique_ptr< PPCallbacks > indexMacrosCallback(IndexDataConsumer &Consumer, IndexingOptions Opts)
Creates a PPCallbacks that indexes macros and feeds macros to Consumer.
void indexTopLevelDecls(ASTContext &Ctx, Preprocessor &PP, ArrayRef< const Decl * > Decls, IndexDataConsumer &DataConsumer, IndexingOptions Opts)
Recursively indexes Decls.
void indexModuleFile(serialization::ModuleFile &Mod, ASTReader &Reader, IndexDataConsumer &DataConsumer, IndexingOptions Opts)
Recursively indexes all top-level decls in the module.
std::unique_ptr< ASTConsumer > createIndexingASTConsumer(std::shared_ptr< IndexDataConsumer > DataConsumer, const IndexingOptions &Opts, std::shared_ptr< Preprocessor > PP)
Creates an ASTConsumer that indexes all symbols (macros and AST decls).
std::unique_ptr< FrontendAction > createIndexingAction(std::shared_ptr< IndexDataConsumer > DataConsumer, const IndexingOptions &Opts)
Creates a frontend action that indexes all symbols (macros and AST decls).
void indexASTUnit(ASTUnit &Unit, IndexDataConsumer &DataConsumer, IndexingOptions Opts)
Recursively indexes all decls in the AST.
@ ModuleFile
The module file (.pcm). Required.
The JSON file list parser is used to communicate input to InstallAPI.