Update compiler-warnings-c4000-through-c4199.md (#5551)

Rastaban · web-flow · commit 04d0f956ff13 · 2024-04-18T10:37:02.000-07:00
* Learn Editor: Update compiler-warnings-c4000-through-c4199.md

* Learn Editor: Update compiler-warnings-c4000-through-c4199.md

* Update compiler-warnings-c4000-through-c4199.md

* Update toc.yml

* Update compiler-warning-level-4-c4001.md

* Update compiler-warning-level-1-c4002.md

* Update compiler-warning-level-1-c4003.md

* Update compiler-warning-level-2-c4007.md

* Update compiler-warning-level-1-c4052.md

* Update compiler-warning-level-4-c4061.md

* Update compiler-warning-level-4-c4061.md

* Update compiler-warning-level-4-c4062.md

* Update compiler-warning-level-1-c4091.md

* Update compiler-warning-level-3-c4101.md

* Update compiler-warning-levels-1-and-4-c4112.md

* Update compiler-warning-level-3-c4133.md

* Update compiler-warning-level-1-c4141.md

* Update compiler-warning-level-4-c4189.md

* Update compiler-warning-level-3-c4191.md

* Update compiler-warning-level-1-c4002.md

* Update compiler-warning-level-1-c4002.md

* Update compiler-warning-level-1-c4052.md

* Update compiler-warning-level-1-c4091.md

* Update compiler-warning-level-2-c4007.md

* Update compiler-warning-level-3-c4101.md

* Update compiler-warning-level-3-c4133.md

* Update compiler-warning-level-3-c4191.md

* Update compiler-warning-level-4-c4001.md

* Update compiler-warning-level-4-c4061.md

* Update compiler-warning-level-4-c4062.md

* Update compiler-warning-level-4-c4189.md

* Update compiler-warning-levels-1-and-4-c4112.md

* Update compiler-warning-level-4-c4061.md

* Update compiler-warnings-c4000-through-c4199.md
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md
@@ -1,18 +1,17 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4002"
-title: "Compiler Warning (level 1) C4002"
+description: "Learn more about: Compiler Warning (level 1, Error) C4002"
+title: "Compiler Warning (level 1, Error) C4002"
 ms.date: "11/04/2016"
 f1_keywords: ["C4002"]
 helpviewer_keywords: ["C4002"]
-ms.assetid: 6bda1dfe-e2e4-4771-9794-5a404c466dd5
 ---
-# Compiler Warning (level 1) C4002
+# Compiler Warning (level 1, Error) C4002
 
-too many actual parameters for macro 'identifier'
+> too many arguments for function-like macro invocation '*identifier*'
 
 The number of actual parameters in the macro exceeds the number of formal parameters in the macro definition. The preprocessor collects the extra parameters but ignores them during macro expansion.
 
-C4002 can occur when incorrectly using [Variadic Macros](../../preprocessor/variadic-macros.md).
+C4002 can occur when incorrectly using [variadic macros](../../preprocessor/variadic-macros.md).
 
 The following sample generates C4002:
 
@@ -32,7 +31,7 @@ int main() {
 
 This error can also be generated as a result of compiler conformance work that was done for Visual Studio .NET 2003: extra commas in macro no longer accepted.
 
-The compiler will no longer accept extra commas in a macro. For code to be valid in both the Visual Studio .NET 2003 and Visual Studio .NET versions of Visual C++, remove the extra commas.
+The compiler no longer accepts extra commas in a macro. For code to be valid in both the Visual Studio .NET 2003 and Visual Studio .NET versions of Visual C++, remove the extra commas.
 
 ```cpp
 // C4002b.cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md
@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4003"
-title: "Compiler Warning (level 1) C4003"
+description: "Learn more about: Compiler Warning (level 1, Error) C4003"
+title: "Compiler Warning (level 1, Error) C4003"
 ms.date: "11/04/2016"
 f1_keywords: ["C4003"]
 helpviewer_keywords: ["C4003"]
-ms.assetid: 0ed1c285-4428-4c90-8131-86897e31f115
 ---
-# Compiler Warning (level 1) C4003
+# Compiler Warning (level 1, Error) C4003
 
-not enough actual parameters for macro 'identifier'
+> not enough arguments for function-like macro invocation '*identifier*'
 
 The number of formal parameters in the macro definition exceeds the number of actual parameters in the macro. Macro expansion substitutes empty text for the missing parameters.
 
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md
@@ -1,16 +1,15 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4052"
-title: "Compiler Warning (level 1) C4052"
+description: "Learn more about: Compiler Warning (level 1 and level 4) C4052"
+title: "Compiler Warning (level 1 and level 4) C4052"
 ms.date: "11/04/2016"
 f1_keywords: ["C4052"]
 helpviewer_keywords: ["C4052"]
-ms.assetid: f9955421-16ab-46e5-8f9d-bf1639a519ef
 ---
-# Compiler Warning (level 1) C4052
+# Compiler Warning (level 1 and level 4) C4052
 
-function declarations different; one contains variable arguments
+> function declarations different; one contains variable arguments
 
-One declaration of the function does not contain variable arguments. It is ignored.
+One declaration of the function doesn't contain variable arguments. The empty declaration is ignored.
 
 The following sample generates C4052:
 
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md
@@ -1,16 +1,15 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4091"
-title: "Compiler Warning (level 1) C4091"
+description: "Learn more about: Compiler Warning (level 1 and level 2) C4091"
+title: "Compiler Warning (level 1 and level 2) C4091"
 ms.date: "11/04/2016"
 f1_keywords: ["C4091"]
 helpviewer_keywords: ["C4091"]
-ms.assetid: 3a404967-ab42-49b0-b324-fd7ba1859d78
 ---
-# Compiler Warning (level 1) C4091
+# Compiler Warning (level 1 and level 2) C4091
 
-'keyword' : ignored on left of 'type' when no variable is declared
+> '*keyword*': ignored on left of '*type*' when no variable is declared
 
-The compiler detected a situation where the user probably intended a variable to be declared, but the compiler was not able to declare the variable.
+The compiler detected a situation where the user probably intended a variable to be declared, but the compiler wasn't able to declare the variable.
 
 ## Examples
 
@@ -29,7 +28,7 @@ __declspec(dllimport) class X2 {} varX;
 class __declspec(dllimport) X3 {};
 ```
 
-If an identifier is a typedef, it cannot also be a variable name. The following sample generates C4091.
+If an identifier is a typedef, it can't also be a variable name. The following sample generates C4091.
 
 ```cpp
 // C4091_b.cpp
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md
@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: Compiler Warning (level 1) C4141"
-title: "Compiler Warning (level 1) C4141"
+description: "Learn more about: Compiler Warning (level 1, Error) C4141"
+title: "Compiler Warning (level 1, Error) C4141"
 ms.date: "11/04/2016"
 f1_keywords: ["C4141"]
 helpviewer_keywords: ["C4141"]
-ms.assetid: 6ce8c058-7f4c-41cf-93e7-90a466744656
 ---
-# Compiler Warning (level 1) C4141
+# Compiler Warning (level 1, Error) C4141
 
-'modifier' : used more than once
+> '*modifier*': used more than once
 
 ## Example
 
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md
@@ -1,13 +1,12 @@
 ---
-description: "Learn more about: Compiler Warning (level 2) C4007"
-title: "Compiler Warning (level 2) C4007"
+description: "Learn more about: Compiler Warning (level 3) C4007"
+title: "Compiler Warning (level 3) C4007"
 ms.date: "11/04/2016"
 f1_keywords: ["C4007"]
 helpviewer_keywords: ["C4007"]
-ms.assetid: 56a70c07-59a5-4fd7-80ed-63592c65cbb7
 ---
-# Compiler Warning (level 2) C4007
+# Compiler Warning (level 3) C4007
 
-'function' : must be 'attribute'
+> '*function*': must be '*attribute*'
 
-A required attribute for a function is not explicitly stated. For example, the function **main** must have the **`__cdecl`** attribute. The compiler forces the attribute.
+A required attribute for a function isn't explicitly stated. For example, the function `main` must have the `__cdecl` attribute. The compiler forces the attribute.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md
@@ -1,16 +1,15 @@
 ---
-description: "Learn more about: Compiler Warning (level 3) C4101"
-title: "Compiler Warning (level 3) C4101"
+description: "Learn more about: Compiler Warning (level 3 and level 4) C4101"
+title: "Compiler Warning (level 3 and level 4) C4101"
 ms.date: "11/04/2016"
 f1_keywords: ["C4101"]
 helpviewer_keywords: ["C4101"]
-ms.assetid: d98563cd-9dce-4aae-8f12-bd552a4ea677
 ---
-# Compiler Warning (level 3) C4101
+# Compiler Warning (level 3 and level 4) C4101
 
-'identifier' : unreferenced local variable
+> '*identifier*': unreferenced local variable
 
-The local variable is never used. This warning will occur in the obvious situation:
+The local variable is never used. This warning occurs in the obvious situation:
 
 ```cpp
 // C4101a.cpp
@@ -20,7 +19,7 @@ int i;   // C4101
 }
 ```
 
-However, this warning will also occur when calling a **`static`** member function through an instance of the class:
+However, this warning also occurs when calling a **`static`** member function through an instance of the class:
 
 ```cpp
 // C4101b.cpp
@@ -39,7 +38,7 @@ int main() {
 }
 ```
 
-In this situation, the compiler uses information about `si` to access the **`static`** function, but the instance of the class is not needed to call the **`static`** function; hence the warning. To resolve this warning, you could:
+In this situation, the compiler uses information about `si` to access the **`static`** function, but the instance of the class isn't needed to call the **`static`** function; hence the warning. To resolve this warning, you could:
 
 - Add a constructor, in which the compiler would use the instance of `si` in the call to `func`.
 
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md
@@ -1,15 +1,14 @@
 ---
-description: "Learn more about: Compiler Warning (level 3) C4133"
-title: "Compiler Warning (level 3) C4133"
+description: "Learn more about: Compiler Warning (level 1 and level 3) C4133"
+title: "Compiler Warning (level 1 and level 3) C4133"
 ms.date: "11/04/2016"
 f1_keywords: ["C4133"]
 helpviewer_keywords: ["C4133"]
-ms.assetid: bdef87b0-21b3-41ac-9b23-1fa86101a9ac
 ---
-# Compiler Warning (level 3) C4133
+# Compiler Warning (level 1 and level 3) C4133
 
-'type' : incompatible types - from 'type1' to 'type2'
+> '*expression*': incompatible types - from '*type1*' to '*type2*'
 
-This warning can be caused by trying to subtract two pointers of different types.
+This warning is emitted when incompatible types are used in an expression. For example, doing arithmetic operations such as subtraction with different pointer types.
 
 To avoid this warning, provide an appropriate type cast.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md
@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: Compiler Warning (level 3) C4191"
-title: "Compiler Warning (level 3) C4191"
+description: "Learn more about: Compiler Warning (level 3, off) C4191"
+title: "Compiler Warning (level 3, off) C4191"
 ms.date: "11/04/2016"
 f1_keywords: ["C4191"]
 helpviewer_keywords: ["C4191"]
-ms.assetid: 576d3bc6-95b7-448a-af31-5d798452df09
 ---
-# Compiler Warning (level 3) C4191
+# Compiler Warning (level 3, off) C4191
 
-'operator/operation' : unsafe conversion from 'type of expression' to 'type required'
+> '*operation*': unsafe conversion from '*type_of_expression*' to '*type_required*'<br/>Making a function call using the resulting pointer may cause your program to fail
 
 Several operations involving function pointers are considered unsafe:
 
@@ -18,15 +17,15 @@ Several operations involving function pointers are considered unsafe:
 
 - Argument or return types with different sizes, type categories, or classifications.
 
-- Differing argument list lengths (on **`__cdecl`**, only on cast from longer list to shorter list, even if shorter is varargs).
+- Different argument list lengths (on **`__cdecl`**, only on cast from longer list to shorter list, even if shorter is varargs).
 
-- Pointer to data (other than **`void`**<strong>\*</strong>) aliased against a pointer to function.
+- Pointer to data (other than **`void*`**) aliased against a pointer to function.
 
 - Any other type difference that would yield an error or warning on a **`reinterpret_cast`**.
 
 Calling this function through the result pointer might cause your program to crash.
 
-This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information.
+This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).
 
 The following sample generates C4191:
 
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md
@@ -1,20 +1,19 @@
 ---
-description: "Learn more about: Compiler Warning (level 4) C4001"
-title: "Compiler Warning (level 4) C4001"
+description: "Learn more about: Compiler Warning (level 4, no longer emitted) C4001"
+title: "Compiler Warning (level 4, no longer emitted) C4001"
 ms.date: "11/04/2016"
 f1_keywords: ["C4001"]
 helpviewer_keywords: ["C4001"]
-ms.assetid: 414a47fe-d597-425e-9374-6a569231dc0a
 ---
-# Compiler Warning (level 4) C4001
+# Compiler Warning (level 4, no longer emitted) C4001
 
-nonstandard extension 'single line comment' was used
+> nonstandard extension 'single line comment' was used
 
 > [!NOTE]
 > This warning is removed in Visual Studio 2017 version 15.5 because single-line comments are standard in C99.
 
 Single-line comments are standard in C++ and standard in C starting with C99.
-Under strict ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)), C files that contain single-line comments, generate C4001 due to the usage of a nonstandard extension. Since single-line comments are standard in C++, C files containing single-line comments do not produce C4001 when compiling with Microsoft extensions (/Ze).
+Under strict ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)), C files that contain single-line comments, generate C4001 due to the usage of a nonstandard extension. Since single-line comments are standard in C++, C files containing single-line comments don't produce C4001 when compiling with Microsoft extensions (/Ze).
 
 ## Example
 
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md
@@ -1,16 +1,15 @@
 ---
-description: "Learn more about: Compiler Warning (level 4) C4061"
-title: "Compiler Warning (level 4) C4061"
+description: "Learn more about: Compiler Warning (level 4, off) C4061"
+title: "Compiler Warning (level 4, off) C4061"
 ms.date: "04/05/2019"
 f1_keywords: ["C4061"]
 helpviewer_keywords: ["C4061"]
-ms.assetid: a99cf88e-7941-4519-8b1b-f6889d914b2f
 ---
-# Compiler Warning (level 4) C4061
+# Compiler Warning (level 4, off) C4061
 
-> enumerator '*identifier*' in switch of enum '*enumeration*' is not explicitly handled by a case label
+> enumerator '*identifier*' in switch of `enum` '*enumeration*' is not explicitly handled by a `case` label
 
-The specified enumerator *identifier* has no associated handler in a **`switch`** statement that has a **`default`** case. The missing case might be an oversight, or it may not be an issue. It may depend on whether the enumerator is handled by the default case or not. For a related warning on unused enumerators in **`switch`** statements that have no **`default`** case, see [C4062](compiler-warning-level-4-c4062.md).
+The specified enumerator *identifier* has no associated handler in a `switch` statement that has a `default` case. The missing case might be an oversight, or it may not be an issue. Whether the missing `case` is an issue in practice depends on if the default case handles the enumerator. For a related warning on unused enumerators in `switch` statements that have no `default` case, see [C4062](compiler-warning-level-4-c4062.md).
 
 This warning is off by default. For more information about how to enable warnings that are off by default, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).
 
@@ -34,10 +33,6 @@ void func ( E e )
          break;
    }   // C4061 c' not handled
 }
-
-int main()
-{
-}
 ```
 
 ## See also
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md
@@ -1,16 +1,15 @@
 ---
-description: "Learn more about: Compiler Warning (level 4) C4062"
-title: "Compiler Warning (level 4) C4062"
+description: "Learn more about: Compiler Warning (level 4, off) C4062"
+title: "Compiler Warning (level 4, off) C4062"
 ms.date: "04/05/2019"
 f1_keywords: ["C4062"]
 helpviewer_keywords: ["C4062"]
-ms.assetid: 36d1c6ae-c917-4b08-bf30-2eb49ee94169
 ---
-# Compiler Warning (level 4) C4062
+# Compiler Warning (level 4, off) C4062
 
-> enumerator '*identifier*' in switch of enum '*enumeration*' is not handled
+> enumerator '*identifier*' in switch of `enum` '*enumeration*' is not handled
 
-The enumerator *identifier* has no associated `case` handler in a **`switch`** statement, and there's no **`default`** label that can catch it. The missing case may be an oversight, and is a potential error in your code. For a related warning on unused enumerators in **`switch`** statements that have a **`default`** case, see [C4061](compiler-warning-level-4-c4061.md).
+The enumerator *identifier* doesn't have a `case` handler associated with it in a **`switch`** statement, and there's no **`default`** label that can catch it. The missing case may be an oversight, and is a potential error in your code. For a related warning on unused enumerators in **`switch`** statements that have a **`default`** case, see [C4061](compiler-warning-level-4-c4061.md).
 
 This warning is off by default. For more information about how to enable warnings that are off by default, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).
 
@@ -31,9 +30,6 @@ void func ( E e ) {
       break;   // no default label
    }   // C4062, enumerator 'c' not handled
 }
-
-int main() {
-}
 ```
 
 ## See also
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md
@@ -1,11 +1,11 @@
 ---
-description: "Learn more about: Compiler Warning (level 4) C4189"
-title: "Compiler Warning (level 4) C4189"
+description: "Learn more about: Compiler Warning (level 3 and level 4) C4189"
+title: "Compiler Warning (level 3 and level 4) C4189"
 ms.date: 05/03/2021
 f1_keywords: ["C4189"]
 helpviewer_keywords: ["C4189"]
 ---
-# Compiler Warning (level 4) C4189
+# Compiler Warning (level 3 and level 4) C4189
 
 > '*identifier*' : local variable is initialized but not referenced
 
@@ -19,16 +19,16 @@ The following sample generates C4189:
 // C4189.cpp
 // compile with: /W4
 int main() {
-   int a = 1;   // C4189, remove declaration to resolve
+   int a = 1;   // C4189
 }
 ```
 
-Starting in Visual Studio 2017 version 15.5, warning C4189 is emitted in more cases, as shown in the following code:
+In Visual Studio 2017 version 15.5 and later, warning C4189 is emitted in more cases, as shown in the following code:
 
 ```cpp
 void f() {
-    char s[2] = {0}; // C4189. Either use the variable or remove it.
+    char s[2] = {0}; // C4189
 }
 ```
 
-To fix the error, remove the unused variable.
+To fix the error, remove the unused variable or add the `[[maybe_unused]]` attribute.
diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4112.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4112.md
diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md
diff --git a/docs/error-messages/toc.yml b/docs/error-messages/toc.yml
