summaryrefslogtreecommitdiffstats
path: root/clang-tools-extra
diff options
context:
space:
mode:
Diffstat (limited to 'clang-tools-extra')
-rw-r--r--clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.cpp18
-rw-r--r--clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.h2
-rw-r--r--clang-tools-extra/docs/ReleaseNotes.rst5
-rw-r--r--clang-tools-extra/docs/clang-tidy/checks/misc-throw-by-value-catch-by-reference.rst15
4 files changed, 38 insertions, 2 deletions
diff --git a/clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.cpp b/clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.cpp
index b7077a1225f..7b1f7eafe1e 100644
--- a/clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.cpp
+++ b/clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.cpp
@@ -20,7 +20,10 @@ namespace misc {
ThrowByValueCatchByReferenceCheck::ThrowByValueCatchByReferenceCheck(
StringRef Name, ClangTidyContext *Context)
: ClangTidyCheck(Name, Context),
- CheckAnonymousTemporaries(Options.get("CheckThrowTemporaries", true)) {}
+ CheckAnonymousTemporaries(Options.get("CheckThrowTemporaries", true)),
+ WarnOnLargeObject(Options.get("WarnOnLargeObject", false)),
+ // Cannot access `ASTContext` from here so set it to an extremal value.
+ MaxSize(Options.get("MaxSize", std::numeric_limits<uint64_t>::max())) {}
void ThrowByValueCatchByReferenceCheck::registerMatchers(MatchFinder *Finder) {
// This is a C++ only check thus we register the matchers only for C++
@@ -150,8 +153,19 @@ void ThrowByValueCatchByReferenceCheck::diagnoseCatchLocations(
// If it's not a pointer and not a reference then it must be caught "by
// value". In this case we should emit a diagnosis message unless the type
// is trivial.
- if (!caughtType.isTrivialType(context))
+ if (!caughtType.isTrivialType(context)) {
diag(varDecl->getBeginLoc(), diagMsgCatchReference);
+ } else if (WarnOnLargeObject) {
+ // If the type is trivial, then catching it by reference is not dangerous.
+ // However, catching large objects by value decreases the performance.
+
+ // We can now access `ASTContext` so if `MaxSize` is an extremal value
+ // then set it to the size of `size_t`.
+ if (MaxSize == std::numeric_limits<uint64_t>::max())
+ MaxSize = context.getTypeSize(context.getSizeType());
+ if (context.getTypeSize(caughtType) > MaxSize)
+ diag(varDecl->getBeginLoc(), diagMsgCatchReference);
+ }
}
}
diff --git a/clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.h b/clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.h
index b3c8935026f..39025e02b89 100644
--- a/clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.h
+++ b/clang-tools-extra/clang-tidy/misc/ThrowByValueCatchByReferenceCheck.h
@@ -41,6 +41,8 @@ private:
bool isCatchVariable(const DeclRefExpr *declRefExpr);
bool isFunctionOrCatchVar(const DeclRefExpr *declRefExpr);
const bool CheckAnonymousTemporaries;
+ const bool WarnOnLargeObject;
+ uint64_t MaxSize; // No `const` because we have to set it in two steps.
};
} // namespace misc
diff --git a/clang-tools-extra/docs/ReleaseNotes.rst b/clang-tools-extra/docs/ReleaseNotes.rst
index d05030fd67c..f1ee2fe44e9 100644
--- a/clang-tools-extra/docs/ReleaseNotes.rst
+++ b/clang-tools-extra/docs/ReleaseNotes.rst
@@ -170,6 +170,11 @@ Improvements to clang-tidy
Rewrites function signatures to use a trailing return type.
+- The :doc:`misc-throw-by-value-catch-by-reference
+ <clang-tidy/misc-throw-by-value-catch-by-reference.rst>` now supports
+ `WarnOnLargeObject` and `MaxSize` options to warn on any large trivial
+ object caught by value.
+
Improvements to include-fixer
-----------------------------
diff --git a/clang-tools-extra/docs/clang-tidy/checks/misc-throw-by-value-catch-by-reference.rst b/clang-tools-extra/docs/clang-tidy/checks/misc-throw-by-value-catch-by-reference.rst
index 91287d862ff..bbe681a4fbf 100644
--- a/clang-tools-extra/docs/clang-tidy/checks/misc-throw-by-value-catch-by-reference.rst
+++ b/clang-tools-extra/docs/clang-tidy/checks/misc-throw-by-value-catch-by-reference.rst
@@ -32,3 +32,18 @@ Options
<https://www.securecoding.cert.org/confluence/display/cplusplus/ERR09-CPP.+Throw+anonymous+temporaries>`_.
Default is `1`.
+.. option:: WarnOnLargeObject
+
+ Also warns for any large, trivial object caught by value. Catching a large
+ object by value is not dangerous but affects the performance negatively. The
+ maximum size of an object allowed to be caught without warning can be set
+ using the `MaxSize` option.
+ Default is `0`.
+
+.. option:: MaxSize
+
+ Determines the maximum size of an object allowed to be caught without
+ warning. Only applicable if `WarnOnLargeObject` is set to `1`. If option is
+ set by the user to `std::numeric_limits<uint64_t>::max()` then it reverts to
+ the default value.
+ Default is the size of `size_t`.
OpenPOWER on IntegriCloud