annotate clang-tools-extra/clang-tidy/utils/FixItHintUtils.h @ 266:00f31e85ec16 default tip

Added tag current for changeset 31d058e83c98
author Shinji KONO <kono@ie.u-ryukyu.ac.jp>
date Sat, 14 Oct 2023 10:13:55 +0900
parents 1f2b6ac9f198
children
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"
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 221
diff changeset
15 #include <optional>
150
anatofuz
parents:
diff changeset
16
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 221
diff changeset
17 namespace clang::tidy::utils::fixit {
150
anatofuz
parents:
diff changeset
18
anatofuz
parents:
diff changeset
19 /// Creates fix to make ``VarDecl`` a reference by adding ``&``.
anatofuz
parents:
diff changeset
20 FixItHint changeVarDeclToReference(const VarDecl &Var, ASTContext &Context);
anatofuz
parents:
diff changeset
21
anatofuz
parents:
diff changeset
22 /// This enum defines where the qualifier shall be preferably added.
anatofuz
parents:
diff changeset
23 enum class QualifierPolicy {
anatofuz
parents:
diff changeset
24 Left, // Add the qualifier always to the left side, if that is possible.
anatofuz
parents:
diff changeset
25 Right, // Add the qualifier always to the right side.
anatofuz
parents:
diff changeset
26 };
anatofuz
parents:
diff changeset
27
anatofuz
parents:
diff changeset
28 /// This enum defines which entity is the target for adding the qualifier. This
anatofuz
parents:
diff changeset
29 /// makes only a difference for pointer-types. Other types behave identical
anatofuz
parents:
diff changeset
30 /// for either value of \c ConstTarget.
anatofuz
parents:
diff changeset
31 enum class QualifierTarget {
anatofuz
parents:
diff changeset
32 Pointee, /// Transforming a pointer attaches to the pointee and not the
anatofuz
parents:
diff changeset
33 /// pointer itself. For references and normal values this option has
anatofuz
parents:
diff changeset
34 /// no effect. `int * p = &i;` -> `const int * p = &i` or `int const
anatofuz
parents:
diff changeset
35 /// * p = &i`.
anatofuz
parents:
diff changeset
36 Value, /// Transforming pointers will consider the pointer itself.
anatofuz
parents:
diff changeset
37 /// `int * p = &i;` -> `int * const = &i`
anatofuz
parents:
diff changeset
38 };
anatofuz
parents:
diff changeset
39
anatofuz
parents:
diff changeset
40 /// \brief Creates fix to qualify ``VarDecl`` with the specified \c Qualifier.
anatofuz
parents:
diff changeset
41 /// Requires that `Var` is isolated in written code like in `int foo = 42;`.
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 221
diff changeset
42 std::optional<FixItHint>
150
anatofuz
parents:
diff changeset
43 addQualifierToVarDecl(const VarDecl &Var, const ASTContext &Context,
anatofuz
parents:
diff changeset
44 DeclSpec::TQ Qualifier,
anatofuz
parents:
diff changeset
45 QualifierTarget CT = QualifierTarget::Pointee,
anatofuz
parents:
diff changeset
46 QualifierPolicy CP = QualifierPolicy::Left);
252
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 221
diff changeset
47
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 221
diff changeset
48 // \brief Format a pointer to an expression
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 221
diff changeset
49 std::string formatDereference(const Expr &ExprNode, const ASTContext &Context);
1f2b6ac9f198 LLVM16-1
Shinji KONO <kono@ie.u-ryukyu.ac.jp>
parents: 221
diff changeset
50 } // namespace clang::tidy::utils::fixit
150
anatofuz
parents:
diff changeset
51
anatofuz
parents:
diff changeset
52 #endif // LLVM_CLANG_TOOLS_EXTRA_CLANG_TIDY_UTILS_FIXITHINTUTILS_H