AutosarC++17_03-A5.0.3

The declaration of objects shall contain no more than two levels of pointer indirection

Required inputs: IR

Rationale

Use of more than two levels of indirection can seriously impair the ability to understand the behavior of the code, and therefore should be avoided.

Example
// $Id: A5-0-3.cpp 271687 2017-03-23 08:57:35Z piotr.tanski $
#include <cstdint>
using IntPtr = std::int8_t *;
struct S {
std::int8_t *s1;   // Compliant
std::int8_t **s2;  // Compliant
std::int8_t ***s3; // Non-compliant
};
S *ps1;   // Compliant
S **ps2;  // Compliant
S ***ps3; // Non-compliant

std::int8_t **(*pfunc1)();   //   Compliant
std::int8_t **(**pfunc2)();  //   Compliant
std::int8_t **(***pfunc3)(); //   Non-compliant
std::int8_t ***(**pfunc4)(); //   Non-compliant

void fn(std::int8_t *par1,         // Compliant
std::int8_t **par2,        // Compliant
std::int8_t ***par3,       // Non-compliant
IntPtr *par4,              // Compliant
IntPtr *const *const par5, // Non-compliant
std::int8_t *par6[],       // Compliant
std::int8_t **par7[])      // Non-compliant
{
std::int8_t *ptr1;                   // Compliant
std::int8_t **ptr2;                  // Compliant
std::int8_t ***ptr3;                 // Non-compliant
IntPtr *ptr4;                        // Compliant
IntPtr *const *const ptr5 = nullptr; // Non-compliant
std::int8_t *ptr6[10];               // Compliant
std::int8_t **ptr7[10];              // Compliant
}
// Explanation of types
// 1) par1 and ptr1 are of type pointer to std::int8_t.
// 2) par2 and ptr2 are of type pointer to pointer to std::int8_t.
//   3) par3 and ptr3 are of type pointer to a pointer to a pointer
//   to std::int8_t.
//   This is three levels and is non-compliant.
//   4) par4 and ptr4 are expanded to a type of pointer to a pointer to
//   std::int8_t.
//   5) par5 and ptr5 are expanded to a type of const pointer to a const
//   pointer
//   to a pointer to std::int8_t. This is three levels and is non-compliant.
//   6) par6 is of type pointer to pointer to std::int8_t because arrays
//   are converted
//   to a pointer to the initial element of the array.
//   7) ptr6 is of type pointer to array of std::int8_t.
//   8) par7 is of type pointer to pointer to pointer to
//   std::int8_t because arrays are
//   converted to a pointer to the initial element of the array. This is
//   three
//   levels and is non-compliant.
//   9) ptr7 is of type array of pointer to pointer to std::int8_t. This
//   is compliant.
See Also
  • MISRA C++ 2008 [6]: 5-0-19 The declaration of objects shall contain no more than two levels of pointer indirection.

Possible Messages

Key

Text

Severity

Disabled

too_many_pointer_levels

More than {} level{} of pointer indirection

None

False

Options

max_levels

max_levels : int = 2

Maximum number of allowed pointer-indirection levels.