annotate clang-tools-extra/clang-tidy/utils/FixItHintUtils.h @ 150:1d019706d866

LLVM10
author anatofuz
date Thu, 13 Feb 2020 15:10:13 +0900
parents
children 2e18cbf3894f
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 /// Creates fix to make ``VarDecl`` const qualified.
anatofuz
parents:
diff changeset
25 FixItHint changeVarDeclToConst(const VarDecl &Var);
anatofuz
parents:
diff changeset
26
anatofuz
parents:
diff changeset
27 /// This enum defines where the qualifier shall be preferably added.
anatofuz
parents:
diff changeset
28 enum class QualifierPolicy {
anatofuz
parents:
diff changeset
29 Left, // Add the qualifier always to the left side, if that is possible.
anatofuz
parents:
diff changeset
30 Right, // Add the qualifier always to the right side.
anatofuz
parents:
diff changeset
31 };
anatofuz
parents:
diff changeset
32
anatofuz
parents:
diff changeset
33 /// This enum defines which entity is the target for adding the qualifier. This
anatofuz
parents:
diff changeset
34 /// makes only a difference for pointer-types. Other types behave identical
anatofuz
parents:
diff changeset
35 /// for either value of \c ConstTarget.
anatofuz
parents:
diff changeset
36 enum class QualifierTarget {
anatofuz
parents:
diff changeset
37 Pointee, /// Transforming a pointer attaches to the pointee and not the
anatofuz
parents:
diff changeset
38 /// pointer itself. For references and normal values this option has
anatofuz
parents:
diff changeset
39 /// no effect. `int * p = &i;` -> `const int * p = &i` or `int const
anatofuz
parents:
diff changeset
40 /// * p = &i`.
anatofuz
parents:
diff changeset
41 Value, /// Transforming pointers will consider the pointer itself.
anatofuz
parents:
diff changeset
42 /// `int * p = &i;` -> `int * const = &i`
anatofuz
parents:
diff changeset
43 };
anatofuz
parents:
diff changeset
44
anatofuz
parents:
diff changeset
45 /// \brief Creates fix to qualify ``VarDecl`` with the specified \c Qualifier.
anatofuz
parents:
diff changeset
46 /// Requires that `Var` is isolated in written code like in `int foo = 42;`.
anatofuz
parents:
diff changeset
47 Optional<FixItHint>
anatofuz
parents:
diff changeset
48 addQualifierToVarDecl(const VarDecl &Var, const ASTContext &Context,
anatofuz
parents:
diff changeset
49 DeclSpec::TQ Qualifier,
anatofuz
parents:
diff changeset
50 QualifierTarget CT = QualifierTarget::Pointee,
anatofuz
parents:
diff changeset
51 QualifierPolicy CP = QualifierPolicy::Left);
anatofuz
parents:
diff changeset
52 } // namespace fixit
anatofuz
parents:
diff changeset
53 } // namespace utils
anatofuz
parents:
diff changeset
54 } // namespace tidy
anatofuz
parents:
diff changeset
55 } // namespace clang
anatofuz
parents:
diff changeset
56
anatofuz
parents:
diff changeset
57 #endif // LLVM_CLANG_TOOLS_EXTRA_CLANG_TIDY_UTILS_FIXITHINTUTILS_H