From 536c01c3688689cff1c391adc278b360c0610ee8 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:42:14 +0800 Subject: [PATCH 1/4] Add blockquotes for error messages in range [C1001, C1020] --- docs/error-messages/compiler-errors-1/fatal-error-c1002.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1003.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1004.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1005.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1007.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1008.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1009.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1012.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1013.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1014.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1016.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1017.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1018.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1019.md | 2 +- 14 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md index c001659abf..a94bd3d71b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md @@ -8,7 +8,7 @@ ms.assetid: bd6d274a-c7b4-43af-8bf2-23c5e442aa22 --- # Fatal Error C1002 -compiler is out of heap space in pass 2 +> compiler is out of heap space in pass 2 The compiler ran out of dynamic memory space during its second pass, probably due to a program with too many symbols or complex expressions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md index 651a5259ea..7197953624 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md @@ -8,6 +8,6 @@ ms.assetid: 27d2d009-2e0f-41fb-8bfc-372752fbe920 --- # Fatal Error C1003 -error count exceeds number; stopping compilation +> error count exceeds number; stopping compilation Errors in the program are too numerous to allow recovery. The compiler must terminate. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index 266090b83c..87b433e091 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -8,7 +8,7 @@ ms.assetid: dbe034b0-6eb0-41b4-a50c-2fccf9e78ad4 --- # Fatal Error C1004 -unexpected end of file found +> unexpected end of file found The compiler reached the end of a source file without resolving a construct. The code may be missing one of the following elements: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md index cbb2d4aa5b..9040fac4b4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md @@ -8,7 +8,7 @@ ms.assetid: 150daf8e-a38a-4669-9c1a-a05b5a1f65ef --- # Fatal Error C1005 -string too big for buffer +> string too big for buffer A string in a compiler intermediate file overflowed a buffer. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md index 23d81272a5..b286bc82bb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md @@ -8,6 +8,6 @@ ms.assetid: 224f7e2c-4522-4e09-b455-8d293bdb799d --- # Fatal Error C1007 -unrecognized flag string in option +> unrecognized flag string in option The command-line option contains an invalid string. Check the **CL** command line and environment variable for errors. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md index df73ac1ebd..8bbec4302f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md @@ -8,6 +8,6 @@ ms.assetid: 7de729e3-b2ca-4a68-95ab-8a1c920f3f2c --- # Fatal Error C1008 -no input file specified +> no input file specified The compiler was not given a C or C++ source file to compile. Check the **CL** command line and environment variable for filename specifications. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md index 358d670bec..2eaba99ce2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md @@ -8,6 +8,6 @@ ms.assetid: dcc8383c-3362-4c47-9c26-25d2451ebd53 --- # Fatal Error C1009 -compiler limit : macros nested too deeply +> compiler limit : macros nested too deeply The compiler tried to expand too many macros at the same time. The compiler has a limit of 256 levels of nested macros. Split nested macros into simpler macros. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 21849c9d15..11814ea9a7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["C1012"] --- # Fatal Error C1012 -unmatched parenthesis: missing 'character' +> unmatched parenthesis: missing 'character' The parentheses in a preprocessor directive do not match. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md index c8950e24e8..3c5d5926a4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md @@ -8,7 +8,7 @@ ms.assetid: 5514a679-efe7-4055-bdd3-5693ca0c332f --- # Fatal Error C1013 -compiler limit : too many open parentheses +> compiler limit : too many open parentheses An expression contains too many levels of parentheses in a single expression. Simplify the expression or break it into multiple statements. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md index 084aa82fad..a6062affce 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md @@ -8,6 +8,6 @@ ms.assetid: 4c01ef70-e765-4d07-a3fe-a11c19fb610b --- # Fatal Error C1014 -too many include files : depth = level +> too many include files : depth = level The nesting of `#include` directives is too deep. Nested directives can include open files. The source file containing the directive counts as one file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index c921566c37..98ff599e32 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -8,7 +8,7 @@ ms.assetid: 33f45c3e-2d8f-43ad-a445-c412d1d54ce1 --- # Fatal Error C1016 -\#ifdef expected an identifier#ifndef expected an identifier +> #ifdef expected an identifier#ifndef expected an identifier The conditional compilation directive ([#ifdef](../../preprocessor/hash-ifdef-and-hash-ifndef-directives-c-cpp.md) or `#ifndef`) has no identifier to evaluate. To resolve the error, specify an identifier. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index cd6fbcbc77..271591edcb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -8,7 +8,7 @@ ms.assetid: 5542e604-599d-4e36-8f83-1d454c5753c9 --- # Fatal Error C1017 -invalid integer constant expression +> invalid integer constant expression The expression in an `#if` directive did not exist or did not evaluate to a constant. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index 4283dedc9d..096eb08d0b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -8,7 +8,7 @@ ms.assetid: 2ceb8a99-30b2-4b80-bf42-e9f3305b3c52 --- # Fatal Error C1018 -unexpected #elif +> unexpected #elif The `#elif` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#elif` only within one of these constructs. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index 5d51ab87de..f209742896 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -8,7 +8,7 @@ ms.assetid: c4f8968b-bc62-4200-b3ca-69d06c163236 --- # Fatal Error C1019 -unexpected #else +> unexpected #else The `#else` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#else` only within one of these constructs. From 7ce83a17a83be62e65c66e521a657de858272ccb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:48:41 +0800 Subject: [PATCH 2/4] Add "Remarks" and "Example" headings for error references in range [C1001, C1020] --- docs/error-messages/compiler-errors-1/fatal-error-c1001.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1002.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1003.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1004.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1005.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1007.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1008.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1009.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1012.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1013.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1014.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1015.md | 2 ++ docs/error-messages/compiler-errors-1/fatal-error-c1016.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1017.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1018.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1019.md | 4 ++++ docs/error-messages/compiler-errors-1/fatal-error-c1020.md | 2 +- 17 files changed, 45 insertions(+), 1 deletion(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md index d2dc62f249..2bbbd56ed0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md @@ -10,6 +10,8 @@ ms.assetid: 5736cdb3-22c8-4fad-aa85-d5e0d2b232f4 > INTERNAL COMPILER ERROR(compiler file *file*, line *number*) +## Remarks + The compiler cannot generate correct code for a construct, often due to the combination of a particular expression and an optimization option, or an issue in parsing. If the compiler file listed has a utc or C2 path segment, it is probably an optimization error. If the file has a cxxfe or c1xx path segment, or is msc1.cpp, it is probably a parser error. If the file named is cl.exe, there is no other information available. You can often fix an optimization problem by removing one or more optimization options. To determine which option is at fault, remove options one at a time and recompile until the error message goes away. The options most commonly responsible are [/Og (Global optimizations)](../../build/reference/og-global-optimizations.md) and [/Oi (Generate Intrinsic Functions)](../../build/reference/oi-generate-intrinsic-functions.md). Once you determine which optimization option is responsible, you can disable it around the function where the error occurs by using the [optimize](../../preprocessor/optimize.md) pragma, and continue to use the option for the rest of the module. For more information about optimization options, see [Optimization best practices](../../build/optimization-best-practices.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md index a94bd3d71b..f522ddffad 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md @@ -10,6 +10,8 @@ ms.assetid: bd6d274a-c7b4-43af-8bf2-23c5e442aa22 > compiler is out of heap space in pass 2 +## Remarks + The compiler ran out of dynamic memory space during its second pass, probably due to a program with too many symbols or complex expressions. ### To fix by using the following possible solutions diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md index 7197953624..a4acb20be0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md @@ -10,4 +10,6 @@ ms.assetid: 27d2d009-2e0f-41fb-8bfc-372752fbe920 > error count exceeds number; stopping compilation +## Remarks + Errors in the program are too numerous to allow recovery. The compiler must terminate. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index 87b433e091..2f1b2bb37e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -10,6 +10,8 @@ ms.assetid: dbe034b0-6eb0-41b4-a50c-2fccf9e78ad4 > unexpected end of file found +## Remarks + The compiler reached the end of a source file without resolving a construct. The code may be missing one of the following elements: - A closing brace @@ -28,6 +30,8 @@ To resolve this error, check for the following: - A source file does not end with a carriage return and line feed. +## Example + The following sample generates C1004: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md index 9040fac4b4..41aa8016a7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md @@ -10,6 +10,8 @@ ms.assetid: 150daf8e-a38a-4669-9c1a-a05b5a1f65ef > string too big for buffer +## Remarks + A string in a compiler intermediate file overflowed a buffer. You could get this error when the parameter that you pass to either the [/Fd](../../build/reference/fd-program-database-file-name.md) or [/Yl](../../build/reference/yl-inject-pch-reference-for-debug-library.md) compiler options is greater than 256 bytes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md index b286bc82bb..4f5d07421f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md @@ -10,4 +10,6 @@ ms.assetid: 224f7e2c-4522-4e09-b455-8d293bdb799d > unrecognized flag string in option +## Remarks + The command-line option contains an invalid string. Check the **CL** command line and environment variable for errors. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md index 8bbec4302f..e2a23dbb26 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md @@ -10,4 +10,6 @@ ms.assetid: 7de729e3-b2ca-4a68-95ab-8a1c920f3f2c > no input file specified +## Remarks + The compiler was not given a C or C++ source file to compile. Check the **CL** command line and environment variable for filename specifications. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md index 2eaba99ce2..749692f4b6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md @@ -10,4 +10,6 @@ ms.assetid: dcc8383c-3362-4c47-9c26-25d2451ebd53 > compiler limit : macros nested too deeply +## Remarks + The compiler tried to expand too many macros at the same time. The compiler has a limit of 256 levels of nested macros. Split nested macros into simpler macros. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 11814ea9a7..269fc28fef 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -9,8 +9,12 @@ helpviewer_keywords: ["C1012"] > unmatched parenthesis: missing 'character' +## Remarks + The parentheses in a preprocessor directive do not match. +## Example + The following sample generates C1012: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md index 3c5d5926a4..2587dcaf3f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md @@ -10,6 +10,8 @@ ms.assetid: 5514a679-efe7-4055-bdd3-5693ca0c332f > compiler limit : too many open parentheses +## Remarks + An expression contains too many levels of parentheses in a single expression. Simplify the expression or break it into multiple statements. Prior to Visual C++ 6.0 Service Pack 3, the limit on nested parenthesis in a single expression was 59. Currently, the limit on nested parenthesis is 256. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md index a6062affce..b8ce439c78 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md @@ -10,4 +10,6 @@ ms.assetid: 4c01ef70-e765-4d07-a3fe-a11c19fb610b > too many include files : depth = level +## Remarks + The nesting of `#include` directives is too deep. Nested directives can include open files. The source file containing the directive counts as one file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1015.md b/docs/error-messages/compiler-errors-1/fatal-error-c1015.md index 71edb00f18..7b161e0ef8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1015.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1015.md @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1015"] > header-names '*header-name*' and '*header-name*' identify the same header and cannot be used as both `/headerUnit:quote` and `/headerUnit:angle` arguments; please provide this header-name only once +## Remarks + Don't include a header unit using both double-quotes and angle brackets. Use only one form, consistent with the **`/headerUnit:quote`** or **`/headerUnit:angle`** compiler option. For more information, see [`/headerUnit` (Use header unit IFC)](../../build/reference/headerunit.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index 98ff599e32..51c3533c6a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -10,8 +10,12 @@ ms.assetid: 33f45c3e-2d8f-43ad-a445-c412d1d54ce1 > #ifdef expected an identifier#ifndef expected an identifier +## Remarks + The conditional compilation directive ([#ifdef](../../preprocessor/hash-ifdef-and-hash-ifndef-directives-c-cpp.md) or `#ifndef`) has no identifier to evaluate. To resolve the error, specify an identifier. +## Example + The following sample generates C1016: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index 271591edcb..8acf1f2867 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -10,10 +10,14 @@ ms.assetid: 5542e604-599d-4e36-8f83-1d454c5753c9 > invalid integer constant expression +## Remarks + The expression in an `#if` directive did not exist or did not evaluate to a constant. Constants defined using `#define` must have values that evaluate to an integer constant if they are used in an `#if`, `#elif`, or `#else` directive. +## Example + The following sample generates C1017: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index 096eb08d0b..0c9542ff9c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -10,8 +10,12 @@ ms.assetid: 2ceb8a99-30b2-4b80-bf42-e9f3305b3c52 > unexpected #elif +## Remarks + The `#elif` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#elif` only within one of these constructs. +## Example + The following sample generates C1018: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index f209742896..04de2828c0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -10,8 +10,12 @@ ms.assetid: c4f8968b-bc62-4200-b3ca-69d06c163236 > unexpected #else +## Remarks + The `#else` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#else` only within one of these constructs. +## Example + The following sample generates C1019: ```cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md index 1fb7fcdb59..195e1ed8ba 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md @@ -16,7 +16,7 @@ The `#endif` directive has no matching `#if`, `#ifdef`, or `#ifndef` directive. This error can occur if you have conditional preprocessor directives before you include a precompiled header file. The compiler ignores everything in the file before the precompiled header, including any `#if`, `#ifdef`, or `#ifndef` directives. For more information, see [`/Yu` (Use precompiled header)](../../build/reference/yu-use-precompiled-header-file.md). -## Examples +## Example The following sample generates C1020: From e30c6109a9d6993a18ada97a6445f30e96c8d773 Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:50:56 +0800 Subject: [PATCH 3/4] Replace term "sample" with "example" for error references in range [C1001, C1020] --- docs/error-messages/compiler-errors-1/fatal-error-c1004.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1012.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1016.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1017.md | 4 ++-- docs/error-messages/compiler-errors-1/fatal-error-c1018.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1019.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1020.md | 2 +- 7 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index 2f1b2bb37e..a759e67af0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -32,7 +32,7 @@ To resolve this error, check for the following: ## Example -The following sample generates C1004: +The following example generates C1004: ```cpp // C1004.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 269fc28fef..422565f141 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -15,7 +15,7 @@ The parentheses in a preprocessor directive do not match. ## Example -The following sample generates C1012: +The following example generates C1012: ```cpp // C1012.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index 51c3533c6a..0f017949ec 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -16,7 +16,7 @@ The conditional compilation directive ([#ifdef](../../preprocessor/hash-ifdef-an ## Example -The following sample generates C1016: +The following example generates C1016: ```cpp // C1016.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index 8acf1f2867..f67c8d1110 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -18,7 +18,7 @@ Constants defined using `#define` must have values that evaluate to an integer c ## Example -The following sample generates C1017: +The following example generates C1017: ```cpp // C1017.cpp @@ -39,7 +39,7 @@ Possible resolution: Because `CONSTANT_NAME` evaluates to a string and not an integer, the `#if` directive generates fatal error C1017. -In other cases, the preprocessor evaluates an undefined constant as zero. This can cause unintended results, as shown in the following sample. `YES` is undefined, so it evaluates to zero. The expression `#if` `CONSTANT_NAME` evaluates to false and the code to be used on `YES` is removed by the preprocessor. `NO` is also undefined (zero), so `#elif` `CONSTANT_NAME==NO` evaluates to true (`0 == 0`), causing the preprocessor to leave the code in the `#elif` portion of the statement — exactly the opposite of the intended behavior. +In other cases, the preprocessor evaluates an undefined constant as zero. This can cause unintended results, as shown in the following example. `YES` is undefined, so it evaluates to zero. The expression `#if` `CONSTANT_NAME` evaluates to false and the code to be used on `YES` is removed by the preprocessor. `NO` is also undefined (zero), so `#elif` `CONSTANT_NAME==NO` evaluates to true (`0 == 0`), causing the preprocessor to leave the code in the `#elif` portion of the statement — exactly the opposite of the intended behavior. ```cpp // C1017c.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index 0c9542ff9c..cdc38c2364 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -16,7 +16,7 @@ The `#elif` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct ## Example -The following sample generates C1018: +The following example generates C1018: ```cpp // C1018.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index 04de2828c0..2ce7ece3c9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -16,7 +16,7 @@ The `#else` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct ## Example -The following sample generates C1019: +The following example generates C1019: ```cpp // C1019.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md index 195e1ed8ba..e90b08144e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md @@ -18,7 +18,7 @@ This error can occur if you have conditional preprocessor directives before you ## Example -The following sample generates C1020: +The following example generates C1020: ```cpp // C1020.cpp From f7309f1e2e2011da58eccd2d2caa58b6dcadc5bb Mon Sep 17 00:00:00 2001 From: Rageking8 <106309953+Rageking8@users.noreply.github.com> Date: Wed, 25 Jun 2025 17:55:32 +0800 Subject: [PATCH 4/4] Update metadata for error references in range [C1001, C1020] --- docs/error-messages/compiler-errors-1/fatal-error-c1001.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1002.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1003.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1004.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1005.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1007.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1008.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1009.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1010.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1011.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1012.md | 2 +- docs/error-messages/compiler-errors-1/fatal-error-c1013.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1014.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1016.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1017.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1018.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1019.md | 5 ++--- docs/error-messages/compiler-errors-1/fatal-error-c1020.md | 3 +-- 18 files changed, 33 insertions(+), 49 deletions(-) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md index 2bbbd56ed0..bcf89b5bd8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1001" title: "Fatal Error C1001" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1001" +ms.date: 11/04/2016 f1_keywords: ["C1001"] helpviewer_keywords: ["C1001"] -ms.assetid: 5736cdb3-22c8-4fad-aa85-d5e0d2b232f4 --- # Fatal Error C1001 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md index f522ddffad..d254d4e5ce 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1002" title: "Fatal Error C1002" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1002" +ms.date: 11/04/2016 f1_keywords: ["C1002"] helpviewer_keywords: ["C1002"] -ms.assetid: bd6d274a-c7b4-43af-8bf2-23c5e442aa22 --- # Fatal Error C1002 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md index a4acb20be0..453e163d0d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1003" title: "Fatal Error C1003" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1003" +ms.date: 11/04/2016 f1_keywords: ["C1003"] helpviewer_keywords: ["C1003"] -ms.assetid: 27d2d009-2e0f-41fb-8bfc-372752fbe920 --- # Fatal Error C1003 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index a759e67af0..e611dbbc9e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1004" title: "Fatal Error C1004" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1004" +ms.date: 11/04/2016 f1_keywords: ["C1004"] helpviewer_keywords: ["C1004"] -ms.assetid: dbe034b0-6eb0-41b4-a50c-2fccf9e78ad4 --- # Fatal Error C1004 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md index 41aa8016a7..2d2a87369b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1005" title: "Fatal Error C1005" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1005" +ms.date: 11/04/2016 f1_keywords: ["C1005"] helpviewer_keywords: ["C1005"] -ms.assetid: 150daf8e-a38a-4669-9c1a-a05b5a1f65ef --- # Fatal Error C1005 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md index 4f5d07421f..55a3c31b1d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1007" title: "Fatal Error C1007" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1007" +ms.date: 11/04/2016 f1_keywords: ["C1007"] helpviewer_keywords: ["C1007"] -ms.assetid: 224f7e2c-4522-4e09-b455-8d293bdb799d --- # Fatal Error C1007 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md index e2a23dbb26..1ad6c868ba 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1008" title: "Fatal Error C1008" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1008" +ms.date: 11/04/2016 f1_keywords: ["C1008"] helpviewer_keywords: ["C1008"] -ms.assetid: 7de729e3-b2ca-4a68-95ab-8a1c920f3f2c --- # Fatal Error C1008 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md index 749692f4b6..5ba6678782 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1009" title: "Fatal Error C1009" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1009" +ms.date: 11/04/2016 f1_keywords: ["C1009"] helpviewer_keywords: ["C1009"] -ms.assetid: dcc8383c-3362-4c47-9c26-25d2451ebd53 --- # Fatal Error C1009 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1010.md b/docs/error-messages/compiler-errors-1/fatal-error-c1010.md index 775bed3719..eb64115ebd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1010.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1010" title: "Fatal Error C1010" -ms.date: "09/03/2019" +description: "Learn more about: Fatal Error C1010" +ms.date: 09/03/2019 f1_keywords: ["C1010"] helpviewer_keywords: ["C1010"] -ms.assetid: dfd035f1-a7a2-40bc-bc92-dc4d7f456767 --- # Fatal Error C1010 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1011.md b/docs/error-messages/compiler-errors-1/fatal-error-c1011.md index b7517a9e35..b50d6450ef 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1011.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1011.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1011" title: "Fatal Error C1011" +description: "Learn more about: Fatal Error C1011" ms.date: 08/17/2022 f1_keywords: ["C1011"] helpviewer_keywords: ["C1011"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 422565f141..33245ef2b6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -1,7 +1,7 @@ --- title: "Fatal Error C1012" description: "Learn more about: Fatal Error C1012" -ms.date: "02/20/2025" +ms.date: 02/20/2025 f1_keywords: ["C1012"] helpviewer_keywords: ["C1012"] --- diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md index 2587dcaf3f..f0f85a0ee1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1013" title: "Fatal Error C1013" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1013" +ms.date: 11/04/2016 f1_keywords: ["C1013"] helpviewer_keywords: ["C1013"] -ms.assetid: 5514a679-efe7-4055-bdd3-5693ca0c332f --- # Fatal Error C1013 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md index b8ce439c78..678465c197 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1014" title: "Fatal Error C1014" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1014" +ms.date: 11/04/2016 f1_keywords: ["C1014"] helpviewer_keywords: ["C1014"] -ms.assetid: 4c01ef70-e765-4d07-a3fe-a11c19fb610b --- # Fatal Error C1014 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index 0f017949ec..5dc38afa6a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1016" title: "Fatal Error C1016" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1016" +ms.date: 11/04/2016 f1_keywords: ["C1016"] helpviewer_keywords: ["C1016"] -ms.assetid: 33f45c3e-2d8f-43ad-a445-c412d1d54ce1 --- # Fatal Error C1016 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index f67c8d1110..7ae9f9c0d6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1017" title: "Fatal Error C1017" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1017" +ms.date: 11/04/2016 f1_keywords: ["C1017"] helpviewer_keywords: ["C1017"] -ms.assetid: 5542e604-599d-4e36-8f83-1d454c5753c9 --- # Fatal Error C1017 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index cdc38c2364..6a4fd9b145 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1018" title: "Fatal Error C1018" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1018" +ms.date: 11/04/2016 f1_keywords: ["C1018"] helpviewer_keywords: ["C1018"] -ms.assetid: 2ceb8a99-30b2-4b80-bf42-e9f3305b3c52 --- # Fatal Error C1018 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index 2ce7ece3c9..b03103db4e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1019" title: "Fatal Error C1019" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1019" +ms.date: 11/04/2016 f1_keywords: ["C1019"] helpviewer_keywords: ["C1019"] -ms.assetid: c4f8968b-bc62-4200-b3ca-69d06c163236 --- # Fatal Error C1019 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md index e90b08144e..877bba743f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1020" title: "Fatal Error C1020" +description: "Learn more about: Fatal Error C1020" ms.date: 07/11/2022 f1_keywords: ["C1020"] helpviewer_keywords: ["C1020"] -ms.assetid: 42f429e2-5e3b-4086-a10d-b99e032e51c5 --- # Fatal Error C1020