1 //===- Mutations.h - mutate syntax trees --------------------*- C++ ---*-=====//
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
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
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"
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);
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);