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