38 lines
1.3 KiB
ReStructuredText
38 lines
1.3 KiB
ReStructuredText
|
.. title:: clang-tidy - readability-redundant-casting
|
||
|
|
|
||
|
|
readability-redundant-casting
|
||
|
|
=============================
|
||
|
|
|
||
|
|
Detects explicit type casting operations that involve the same source and
|
||
|
|
destination types, and subsequently recommend their removal. Covers a range of
|
||
|
|
explicit casting operations, including ``static_cast``, ``const_cast``, C-style
|
||
|
|
casts, and ``reinterpret_cast``. Its primary objective is to enhance code
|
||
|
|
readability and maintainability by eliminating unnecessary type casting.
|
||
|
|
|
||
|
|
.. code-block:: c++
|
||
|
|
|
||
|
|
int value = 42;
|
||
|
|
int result = static_cast<int>(value);
|
||
|
|
|
||
|
|
In this example, the ``static_cast<int>(value)`` is redundant, as it performs
|
||
|
|
a cast from an ``int`` to another ``int``.
|
||
|
|
|
||
|
|
Casting operations involving constructor conversions, user-defined conversions,
|
||
|
|
functional casts, type-dependent casts, casts between distinct type aliases that
|
||
|
|
refer to the same underlying type, as well as bitfield-related casts and casts
|
||
|
|
directly from lvalue to rvalue, are all disregarded by the check.
|
||
|
|
|
||
|
|
Options
|
||
|
|
-------
|
||
|
|
|
||
|
|
.. option:: IgnoreMacros
|
||
|
|
|
||
|
|
If set to `true`, the check will not give warnings inside macros. Default
|
||
|
|
is `true`.
|
||
|
|
|
||
|
|
.. option:: IgnoreTypeAliases
|
||
|
|
|
||
|
|
When set to `false`, the check will consider type aliases, and when set to
|
||
|
|
`true`, it will resolve all type aliases and operate on the underlying
|
||
|
|
types. Default is `false`.
|