Add "Remarks" and "Example" headings for error references in range [C2651, C2670]

Rageking8 · web-flow · commit 270ac1793b3d · 2025-08-03T22:37:19.000+08:00
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md
@@ -10,4 +10,6 @@ ms.assetid: c3524a89-47d1-43f6-9e20-2cda15f9ae8a
 
 > 'data type' : left of 'operator' must be a class, struct or union
 
+## Remarks
+
 To use a template parameter as if it is a class, specialize the class template with a class instead of an integral type.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md
@@ -10,8 +10,12 @@ ms.assetid: 6e3d1a90-a989-4088-8afd-dc82f6a2d66f
 
 > 'identifier' : illegal copy constructor: first parameter must not be an 'identifier'
 
+## Remarks
+
 The first parameter in the copy constructor has the same type as the class, structure, or union for which it is defined. The first parameter can be a reference to the type but not the type itself.
 
+## Example
+
 The following sample generates C2651:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C2653"]
 
 > '*identifier*' : is not a class or namespace name
 
+## Remarks
+
 The language syntax requires a class, structure, union, or namespace name here.
 
 This error can occur when you use a name that has not been declared as a class, structure, union, or namespace in front of a scope operator. To fix this issue, declare the name or include the header that declares the name before it is used.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md
@@ -10,6 +10,8 @@ ms.assetid: ca7de1bd-576b-40bf-96fc-a91984827d20
 
 > 'identifier' : attempt to access member outside a member function
 
+## Remarks
+
 A member is accessed in a declaration. Member data can be accessed only in member functions.
 
 This error can be caused when trying to initialize variables in a declaration. Use a constructor for this purpose.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md
@@ -10,8 +10,12 @@ ms.assetid: beaefa6e-51b3-4df9-9150-960f3fbf40e0
 
 > 'identifier' : definition or redeclaration illegal in current scope
 
+## Remarks
+
 An identifier can be redeclared only at global scope.
 
+## Example
+
 The following sample generates C2655:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md
@@ -10,6 +10,8 @@ ms.assetid: 1ec91186-0735-4904-859b-59da9af2d426
 
 > 'function' : function not allowed as a bit field
 
+## Remarks
+
 A function is declared as a member of a bit field.
 
 This error can be caused by a syntax error in a constructor initializer list.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md
@@ -10,10 +10,14 @@ ms.assetid: f7cf29a9-684a-4605-9469-ecfee9ba4b03
 
 > 'class::*' found at the start of a statement (did you forget to specify a type?)
 
+## Remarks
+
 The line began with a pointer-to-member identifier.
 
 This error can be caused by a missing type specifier in the declaration of a pointer to a member.
 
+## Example
+
 The following sample generates C2657:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md
@@ -10,8 +10,12 @@ ms.assetid: 638368e8-7893-4a14-abec-13c768a9543a
 
 > 'member': redefinition in anonymous struct/union
 
+## Remarks
+
 Two anonymous structures or unions contained member declarations with the same identifier but with different types. Under [/Za](../../build/reference/za-ze-disable-language-extensions.md), you will also get this error for members with the same identifier and type.
 
+## Example
+
 The following sample generates C2658:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md
@@ -10,7 +10,13 @@ ms.assetid: b0883600-4d27-4ca7-a931-8ca6bd48654d
 
 > 'operator' : function as left operand
 
-A function was on the left side of the specified operator. The most common reason for this error is that the compiler has parsed the identifier on the left side of the operator as a function when the developer intended it to be a variable. For more information, see Wikipedia article [Most vexing parse](https://en.wikipedia.org/wiki/Most_vexing_parse). This example shows a function declaration and a variable definition that are easily confused:
+## Remarks
+
+A function was on the left side of the specified operator. The most common reason for this error is that the compiler has parsed the identifier on the left side of the operator as a function when the developer intended it to be a variable. For more information, see Wikipedia article [Most vexing parse](https://en.wikipedia.org/wiki/Most_vexing_parse).
+
+## Examples
+
+This example shows a function declaration and a variable definition that are easily confused:
 
 ```cpp
 // C2659a.cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md
@@ -10,6 +10,8 @@ ms.assetid: 2e01a1db-4f00-4df6-a04d-cb6f70a6922b
 
 > 'function' : function does not take number parameters
 
+## Remarks
+
 The function is called with an incorrect number of parameters.
 
 C2660 can occur if you accidentally call a Windows API function rather than an MFC member function of the same name. To solve this problem:
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md
@@ -10,12 +10,16 @@ ms.assetid: 60021467-71cd-451b-9877-23840c69309f
 
 > 'function' : no overloaded function takes number parameters
 
+## Remarks
+
 Possible causes:
 
 1. Incorrect actual parameters in function call.
 
 1. Missing function declaration.
 
+## Example
+
 The following sample generates C2661:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md
@@ -10,6 +10,8 @@ ms.assetid: e172c2a4-f29e-4034-8232-e7dc6f83689f
 
 > 'function' : cannot convert 'this' pointer from 'type1' to 'type2'
 
+## Remarks
+
 The compiler could not convert the **`this`** pointer from `type1` to `type2`.
 
 This error can be caused by invoking a non-**`const`** member function on a **`const`** object.  Possible resolutions:
@@ -18,6 +20,8 @@ This error can be caused by invoking a non-**`const`** member function on a **`c
 
 - Add **`const`** to the member function.
 
+## Examples
+
 The following sample generates C2662:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md
@@ -10,6 +10,8 @@ ms.assetid: 1e93e368-fd52-42bf-9908-9b6df467c8c9
 
 > 'function' : number overloads have no legal conversions for 'this' pointer
 
+## Remarks
+
 The compiler could not convert **`this`** to any of the overloaded versions of the member function.
 
 This error can be caused by invoking a non-**`const`** member function on a **`const`** object.  Possible resolutions:
@@ -18,6 +20,8 @@ This error can be caused by invoking a non-**`const`** member function on a **`c
 
 1. Add **`const`** to one of the member function overloads.
 
+## Example
+
 The following sample generates C2663:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C2664"]
 
 > 'function' : cannot convert argument n from 'type1' to 'type2'
 
+## Remarks
+
 This parameter conversion problem might happen if an instance of a class is created and an implicit conversion is attempted on a constructor marked with the **`explicit`** keyword. For more information about explicit conversions, see [User-Defined Type Conversions](../../cpp/user-defined-type-conversions-cpp.md).
 
 If a temporary object is passed to a function that takes a reference to an object as a parameter, that reference must be a **`const`** reference.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md
@@ -10,6 +10,8 @@ ms.assetid: a7f99b61-2eae-4f2b-ba75-ea68fd1e8312
 
 > 'function' : none of the number1 overloads can convert parameter number2 from type 'type'
 
+## Remarks
+
 A parameter of the overloaded function cannot be converted to the required type.  Possible resolutions:
 
 - Supply a conversion operator.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md
@@ -10,6 +10,8 @@ ms.assetid: 78364d15-c6eb-439a-9088-e04a0176692b
 
 > 'identifier' : number overloads have similar conversions
 
+## Remarks
+
 An overloaded function or operator is ambiguous.   Formal parameter lists may be too similar for the compiler to resolve the ambiguity.  To resolve this error, explicitly cast one or more of the actual parameters.
 
 ## Examples
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md
@@ -10,6 +10,8 @@ ms.assetid: 3c91d9d1-18fa-4e0d-a9ba-984d38980ca3
 
 > 'function' : none of number overloads have a best conversion
 
+## Remarks
+
 An overloaded function call is ambiguous and cannot be resolved.
 
 The conversion required to match the actual parameters in the function call to one of the overloaded functions must be strictly better than the conversions required by all the other overloaded functions.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md
@@ -10,6 +10,8 @@ ms.assetid: 041e9627-1c76-420e-a653-cfc83f933bd3
 
 > 'function' : ambiguous call to overloaded function
 
+## Remarks
+
 The specified overloaded function call couldn't be resolved. You may want to explicitly cast one or more of the actual parameters.
 
 You can also get this error through template use. If, in the same class, you have a regular member function and a templated member function with the same signature, the templated one must come first. This limitation remains in the current implementation of Visual C++.
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md
@@ -10,6 +10,8 @@ ms.assetid: f9cb8111-bcdc-484b-a863-2c42e15a0496
 
 > member function not allowed in anonymous union
 
+## Remarks
+
 [Anonymous unions](../../cpp/unions.md#anonymous_unions) cannot have member functions.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md
@@ -10,6 +10,8 @@ ms.assetid: 4b3b74c7-a750-4b0d-abd3-216d1234461f
 
 > 'identifier' : the function template cannot convert parameter number from type 'type'
 
+## Remarks
+
 A parameter could not be converted to the required type.
 
 This error may be fixed if you create an explicit conversion.
