Add "Remarks" and "Example" headings for error references in range [C2431, C2460]

Rageking8 · web-flow · commit c784665e14e8 · 2025-07-27T22:11:23.000+08:00
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md
@@ -10,8 +10,12 @@ ms.assetid: 88a5b648-c89f-47d1-a20e-63231ab4f0f7
 
 > illegal index register in 'identifier'
 
+## Remarks
+
 The ESP register is scaled or used as both index and base register. The SIB encoding for the x86 processor does not allow either.
 
+## Example
+
 The following sample generates C2431:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md
@@ -10,8 +10,12 @@ ms.assetid: 0e3326e8-cab1-45a5-b48d-61edd33793e8
 
 > illegal reference to 16-bit data in 'identifier'
 
+## Remarks
+
 A 16-bit register is used as an index or base register. The compiler does not support referencing 16-bit data. 16-bit registers cannot be used as index or base registers when compiling for 32-bit code.
 
+## Example
+
 The following sample generates C2432:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2433.md b/docs/error-messages/compiler-errors-1/compiler-error-c2433.md
@@ -9,6 +9,8 @@ helpviewer_keywords: ["C2433"]
 
 > '*identifier*': '*modifier*' not permitted on data declarations
 
+## Remarks
+
 The **`friend`**, **`virtual`**, and **`inline`** modifiers cannot be used for data declarations.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md
@@ -10,8 +10,12 @@ ms.assetid: ca4cc813-bc1d-4c0a-9a2c-3a5fe673d084
 
 > 'identifier' : member function or nested class in constructor initializer list
 
+## Remarks
+
 Member functions or local classes in the constructor initializer list cannot be initialized.
 
+## Example
+
 The following sample generates C2436:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md
@@ -10,8 +10,12 @@ ms.assetid: 2d2b3c6c-856a-4b27-ae10-64813b3e5483
 
 > 'identifier' : already initialized
 
+## Remarks
+
 An object can be initialized only once.
 
+## Example
+
 The following sample generates C2437:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md
@@ -10,8 +10,12 @@ ms.assetid: 3a0ab3ba-d0e4-4d8f-971d-e503397cc827
 
 > 'identifier' : cannot initialize static class data via constructor
 
+## Remarks
+
 A constructor is used to initialize a static member of a class. Static members must be initialized in a definition outside the class declaration.
 
+## Example
+
 The following sample generates C2438:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md
@@ -10,6 +10,8 @@ ms.assetid: 3c5dbe5c-b7d3-4bb0-8619-92f6e280461e
 
 > 'identifier' : member could not be initialized
 
+## Remarks
+
 A class, structure, or union member cannot be initialized.
 
 ### To fix by checking the following possible causes
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2440.md b/docs/error-messages/compiler-errors-1/compiler-error-c2440.md
@@ -11,10 +11,10 @@ no-loc: ["struct", "const"]
 > '*initializing*' : cannot convert from '*type1*' to '*type2*'\
 > '*conversion*' : cannot convert from '*type1*' to '*type2*'
 
-The compiler can't implicitly convert from *`type1`* to *`type2`*, or can't use the specified cast or conversion operator.
-
 ## Remarks
 
+The compiler can't implicitly convert from *`type1`* to *`type2`*, or can't use the specified cast or conversion operator.
+
 The compiler generates C2440 when it can't convert from one type to another, either implicitly or by using the specified cast or conversion operator. There are many ways to generate this error. We've listed some common ones in the Examples section.
 
 ## Examples
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md
@@ -10,8 +10,12 @@ ms.assetid: 315330d5-24bc-4193-a531-0642095be58f
 
 > operand size conflict
 
+## Remarks
+
 The instruction requires operands to be the same size.
 
+## Example
+
 The following sample generates C2443:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md
@@ -10,6 +10,8 @@ ms.assetid: 6339ed82-caad-45d3-a8ff-6c746589fd03
 
 > 'identifier' : used ANSI prototype, found 'type', expected '{' or ';'
 
+## Remarks
+
 The function prototype is followed by a type.
 
 This error can be caused by a missing semicolon or curly brace.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md
@@ -10,4 +10,6 @@ ms.assetid: 4f70dd11-6baf-4b92-9a08-f88f65ffa199
 
 > 'operator' : no conversion from 'type1' to 'type2'
 
+## Remarks
+
 The compiler cannot convert `type1` to `type2`. The conversion may not make sense because it violates C/C++ semantics.
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md
@@ -10,10 +10,14 @@ ms.assetid: d1bd6e9a-ee42-4510-ae5e-6b0378f7b931
 
 > '{' : missing function header (old-style formal list?)
 
+## Remarks
+
 The compiler encountered an unexpected open brace at global scope. In most cases, this is caused by a badly-formed function header, a misplaced declaration, or a stray semi-colon. To resolve this issue, verify that the open brace follows a correctly-formed function header, and is not preceded by a declaration or a stray semi-colon.
 
 This error can also be caused by an old-style C-language formal argument list. To resolve this issue, refactor the argument list to use modern style—that is, enclosed in parentheses.
 
+## Example
+
 The following sample generates C2447:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md
@@ -10,10 +10,14 @@ ms.assetid: e255df3c-f861-4b4d-a193-8768cef061a5
 
 > 'identifier' : function-style initializer appears to be a function definition
 
+## Remarks
+
 The function definition is incorrect.
 
 This error can be caused by an old-style C-language formal list.
 
+## Example
+
 The following sample generates C2448:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md
@@ -10,10 +10,14 @@ ms.assetid: 544bf0b6-daa0-40e8-9f21-8e583d472a2d
 
 > found '{' at file scope (missing function header?)
 
+## Remarks
+
 An open brace occurs at file scope.
 
 This error can be caused by a semicolon between a function header and the opening brace of the function definition.
 
+## Example
+
 The following sample generates C2499:
 
 ```c
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md
@@ -9,8 +9,12 @@ helpviewer_keywords: ["C2450"]
 
 > switch expression of type 'type' is illegal
 
+## Remarks
+
 The **`switch`** expression evaluates to an invalid type. It must evaluate to an integer type or a class type with unambiguous conversion to an integer type. If it evaluates to a user-defined type, you must supply a conversion operator.
 
+## Example
+
 The following sample generates C2450:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md
@@ -10,8 +10,12 @@ ms.assetid: a64c93a5-ab8d-4d39-ae57-9ee7ef803036
 
 > conditional expression of type 'type' is illegal
 
+## Remarks
+
 The conditional expression evaluates to an integer type.
 
+## Example
+
 The following sample generates C2451:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md
@@ -10,8 +10,12 @@ ms.assetid: a4ec7642-6660-4c7a-9866-853d1cc67daf
 
 > 'type' : invalid source type for safe_cast
 
+## Remarks
+
 The source type for [safe_cast](../../extensions/safe-cast-cpp-component-extensions.md) was not valid.  For example, all types in a `safe_cast` operation must be CLR types.
 
+## Example
+
 The following sample generates C2452:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md
@@ -10,6 +10,8 @@ ms.assetid: 347e169d-23ad-434f-8836-5b09b53980ff
 
 > '*macro*': predefined macro cannot appear outside of a function body
 
+## Remarks
+
 You attempted to use a predefined macro, such as [`__FUNCTION__`](../../preprocessor/predefined-macros.md), in a global space.
 
 ## Example
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md
@@ -10,8 +10,12 @@ ms.assetid: ed21901f-1067-42f5-b275-19b480decf5c
 
 > 'identifier' : redefinition within definition
 
+## Remarks
+
 A class, structure, union, or enumeration is redefined in its own declaration.
 
+## Example
+
 The following sample generates C2458:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md
@@ -10,8 +10,12 @@ ms.assetid: 81e29f4c-5b60-40fb-9557-1cdc630d77e8
 
 > 'identifier' : is being defined; cannot add as an anonymous member
 
+## Remarks
+
 A class, structure, or union is redefined in its own scope by a member of an anonymous union.
 
+## Example
+
 The following sample generates C2459:
 
 ```cpp
diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md
@@ -10,8 +10,12 @@ ms.assetid: d969fca9-3ac5-4e4e-88fc-df05510e2093
 
 > 'identifier1' : uses 'identifier2', which is being defined
 
+## Remarks
+
 A class or structure (`identifier2`) is declared as a member of itself (`identifier1`). Recursive definitions of classes and structures are not allowed.
 
+## Example
+
 The following sample generates C2460:
 
 ```cpp
