1 | //===- Mutations.h - mutate syntax trees --------------------*- 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 | // Defines high-level APIs for transforming syntax trees and producing the |
9 | // corresponding textual replacements. |
10 | //===----------------------------------------------------------------------===// |
11 | #ifndef LLVM_CLANG_TOOLING_SYNTAX_MUTATIONS_H |
12 | #define LLVM_CLANG_TOOLING_SYNTAX_MUTATIONS_H |
13 | |
14 | #include "clang/Tooling/Core/Replacement.h" |
15 | #include "clang/Tooling/Syntax/Nodes.h" |
16 | #include "clang/Tooling/Syntax/TokenBufferTokenManager.h" |
17 | #include "clang/Tooling/Syntax/Tree.h" |
18 | |
19 | namespace clang { |
20 | namespace syntax { |
21 | |
22 | /// Computes textual replacements required to mimic the tree modifications made |
23 | /// to the syntax tree. |
24 | tooling::Replacements computeReplacements(const TokenBufferTokenManager &TBTM, |
25 | const syntax::TranslationUnit &TU); |
26 | |
27 | /// Removes a statement or replaces it with an empty statement where one is |
28 | /// required syntactically. E.g., in the following example: |
29 | /// if (cond) { foo(); } else bar(); |
30 | /// One can remove `foo();` completely and to remove `bar();` we would need to |
31 | /// replace it with an empty statement. |
32 | /// EXPECTS: S->canModify() == true |
33 | void removeStatement(syntax::Arena &A, TokenBufferTokenManager &TBTM, |
34 | syntax::Statement *S); |
35 | |
36 | } // namespace syntax |
37 | } // namespace clang |
38 | |
39 | #endif |
40 | |