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/Tree.h" 17 18 namespace clang { 19 namespace syntax { 20 21 /// Computes textual replacements required to mimic the tree modifications made 22 /// to the syntax tree. 23 tooling::Replacements computeReplacements(const Arena &A, 24 const syntax::TranslationUnit &TU); 25 26 /// Removes a statement or replaces it with an empty statement where one is 27 /// required syntactically. E.g., in the following example: 28 /// if (cond) { foo(); } else bar(); 29 /// One can remove `foo();` completely and to remove `bar();` we would need to 30 /// replace it with an empty statement. 31 /// EXPECTS: S->canModify() == true 32 void removeStatement(syntax::Arena &A, syntax::Statement *S); 33 34 } // namespace syntax 35 } // namespace clang 36 37 #endif 38