Skip to content

c26461.md

Latest commit

 

History

History
45 lines (35 loc) · 1.22 KB

c26461.md

File metadata and controls

45 lines (35 loc) · 1.22 KB
title C26461
ms.date 03/22/2018
ms.topic reference
f1_keywords
C26461
helpviewer_keywords
C26461
description CppCoreCheck rule that enforces C++ Core Guidelines con.3

C26461 USE_CONST_POINTER_ARGUMENTS:

The pointer argument '%argument%' for function '%function%' can be marked as a pointer to const (con.3).

A function with a T* argument has the potential to modify the value of the object. If that is not the intent of the function, it is better to make the pointer a const T* instead.

See also

C++ Core Guidelines con.3.

Example

struct MyStruct
{
    void MemberFn1() const;
    void MemberFn2();
};

void Function1_Helper(const MyStruct* myStruct);
void Function1(MyStruct* myStruct) // C26461, neither of the operations on myStruct would modify the pointer's value.
{
    if (!myStruct)
        return;

    myStruct->MemberFn1();      // The member function is const
    Function1_Helper(myStruct); // Function1_Helper takes a const
}

void Function2(MyStruct* myStruct)
{
    if (!myStruct)
        return;

    myStruct->MemberFn2(); // The member function is non-const, so no C26461 will be issued
}