annotate clang-tools-extra/clang-tidy/utils/FixItHintUtils.h @ 221:79ff65ed7e25

LLVM12 Original
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Tue, 15 Jun 2021 19:15:29 +0900
parents 1d019706d866
children 1f2b6ac9f198
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
150
anatofuz
parents:
diff changeset
1 //===--- FixItHintUtils.h - clang-tidy---------------------------*- C++ -*-===//
anatofuz
parents:
diff changeset
2 //
anatofuz
parents:
diff changeset
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
anatofuz
parents:
diff changeset
4 // See https://llvm.org/LICENSE.txt for license information.
anatofuz
parents:
diff changeset
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
anatofuz
parents:
diff changeset
6 //
anatofuz
parents:
diff changeset
7 //===----------------------------------------------------------------------===//
anatofuz
parents:
diff changeset
8
anatofuz
parents:
diff changeset
9 #ifndef LLVM_CLANG_TOOLS_EXTRA_CLANG_TIDY_UTILS_FIXITHINTUTILS_H
anatofuz
parents:
diff changeset
10 #define LLVM_CLANG_TOOLS_EXTRA_CLANG_TIDY_UTILS_FIXITHINTUTILS_H
anatofuz
parents:
diff changeset
11
anatofuz
parents:
diff changeset
12 #include "clang/AST/ASTContext.h"
anatofuz
parents:
diff changeset
13 #include "clang/AST/Decl.h"
anatofuz
parents:
diff changeset
14 #include "clang/Sema/DeclSpec.h"
anatofuz
parents:
diff changeset
15
anatofuz
parents:
diff changeset
16 namespace clang {
anatofuz
parents:
diff changeset
17 namespace tidy {
anatofuz
parents:
diff changeset
18 namespace utils {
anatofuz
parents:
diff changeset
19 namespace fixit {
anatofuz
parents:
diff changeset
20
anatofuz
parents:
diff changeset
21 /// Creates fix to make ``VarDecl`` a reference by adding ``&``.
anatofuz
parents:
diff changeset
22 FixItHint changeVarDeclToReference(const VarDecl &Var, ASTContext &Context);
anatofuz
parents:
diff changeset
23
anatofuz
parents:
diff changeset
24 /// This enum defines where the qualifier shall be preferably added.
anatofuz
parents:
diff changeset
25 enum class QualifierPolicy {
anatofuz
parents:
diff changeset
26 Left, // Add the qualifier always to the left side, if that is possible.
anatofuz
parents:
diff changeset
27 Right, // Add the qualifier always to the right side.
anatofuz
parents:
diff changeset
28 };
anatofuz
parents:
diff changeset
29
anatofuz
parents:
diff changeset
30 /// This enum defines which entity is the target for adding the qualifier. This
anatofuz
parents:
diff changeset
31 /// makes only a difference for pointer-types. Other types behave identical
anatofuz
parents:
diff changeset
32 /// for either value of \c ConstTarget.
anatofuz
parents:
diff changeset
33 enum class QualifierTarget {
anatofuz
parents:
diff changeset
34 Pointee, /// Transforming a pointer attaches to the pointee and not the
anatofuz
parents:
diff changeset
35 /// pointer itself. For references and normal values this option has
anatofuz
parents:
diff changeset
36 /// no effect. `int * p = &i;` -> `const int * p = &i` or `int const
anatofuz
parents:
diff changeset
37 /// * p = &i`.
anatofuz
parents:
diff changeset
38 Value, /// Transforming pointers will consider the pointer itself.
anatofuz
parents:
diff changeset
39 /// `int * p = &i;` -> `int * const = &i`
anatofuz
parents:
diff changeset
40 };
anatofuz
parents:
diff changeset
41
anatofuz
parents:
diff changeset
42 /// \brief Creates fix to qualify ``VarDecl`` with the specified \c Qualifier.
anatofuz
parents:
diff changeset
43 /// Requires that `Var` is isolated in written code like in `int foo = 42;`.
anatofuz
parents:
diff changeset
44 Optional<FixItHint>
anatofuz
parents:
diff changeset
45 addQualifierToVarDecl(const VarDecl &Var, const ASTContext &Context,
anatofuz
parents:
diff changeset
46 DeclSpec::TQ Qualifier,
anatofuz
parents:
diff changeset
47 QualifierTarget CT = QualifierTarget::Pointee,
anatofuz
parents:
diff changeset
48 QualifierPolicy CP = QualifierPolicy::Left);
anatofuz
parents:
diff changeset
49 } // namespace fixit
anatofuz
parents:
diff changeset
50 } // namespace utils
anatofuz
parents:
diff changeset
51 } // namespace tidy
anatofuz
parents:
diff changeset
52 } // namespace clang
anatofuz
parents:
diff changeset
53
anatofuz
parents:
diff changeset
54 #endif // LLVM_CLANG_TOOLS_EXTRA_CLANG_TIDY_UTILS_FIXITHINTUTILS_H