| 1 | //===-- CodeInjector.h ------------------------------------------*- 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 | /// \file |
| 10 | /// Defines the clang::CodeInjector interface which is responsible for |
| 11 | /// injecting AST of function definitions that may not be available in the |
| 12 | /// original source. |
| 13 | /// |
| 14 | //===----------------------------------------------------------------------===// |
| 15 | |
| 16 | #ifndef LLVM_CLANG_ANALYSIS_CODEINJECTOR_H |
| 17 | #define LLVM_CLANG_ANALYSIS_CODEINJECTOR_H |
| 18 | |
| 19 | namespace clang { |
| 20 | |
| 21 | class Stmt; |
| 22 | class FunctionDecl; |
| 23 | class ObjCMethodDecl; |
| 24 | |
| 25 | /// CodeInjector is an interface which is responsible for injecting AST |
| 26 | /// of function definitions that may not be available in the original source. |
| 27 | /// |
| 28 | /// The getBody function will be called each time the static analyzer examines a |
| 29 | /// function call that has no definition available in the current translation |
| 30 | /// unit. If the returned statement is not a null pointer, it is assumed to be |
| 31 | /// the body of a function which will be used for the analysis. The source of |
| 32 | /// the body can be arbitrary, but it is advised to use memoization to avoid |
| 33 | /// unnecessary reparsing of the external source that provides the body of the |
| 34 | /// functions. |
| 35 | class CodeInjector { |
| 36 | public: |
| 37 | CodeInjector(); |
| 38 | virtual ~CodeInjector(); |
| 39 | |
| 40 | virtual Stmt *getBody(const FunctionDecl *D) = 0; |
| 41 | virtual Stmt *getBody(const ObjCMethodDecl *D) = 0; |
| 42 | }; |
| 43 | } |
| 44 | |
| 45 | #endif |
| 46 |