Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
33 commits
Select commit Hold shift + click to select a range
6eb3e3d
Convert Math errors list into a table
Rageking8 Jul 11, 2025
6ac6416
Simplify superfluous relative links in "Math errors (M6101 through M6…
Rageking8 Jul 11, 2025
00da185
Remove space before escape in "Math errors (M6101 through M6205)"
Rageking8 Jul 11, 2025
b619183
Update metadata in "Math errors (M6101 through M6205)"
Rageking8 Jul 11, 2025
c013924
Add some missing spaces before backticked terms
Rageking8 Jul 11, 2025
870ffa8
Add blockquotes for error messages in range [C2041, C2060]
Rageking8 Jul 11, 2025
bf148eb
Add "Remarks" and "Example" headings for error references in range [C…
Rageking8 Jul 11, 2025
38d2fde
Replace term "sample" with "example" for error references in range [C…
Rageking8 Jul 11, 2025
2549dd3
Update metadata for error references in range [C2041, C2060]
Rageking8 Jul 11, 2025
e6f7b5c
Add blockquotes for error messages in range [C2061, C2080]
Rageking8 Jul 12, 2025
4db7a0b
Add "Remarks" and "Example" headings for error references in range [C…
Rageking8 Jul 12, 2025
30a7379
Replace term "sample" with "example" for error references in range [C…
Rageking8 Jul 12, 2025
53915d5
Update metadata for error references in range [C2061, C2080]
Rageking8 Jul 12, 2025
b4163d3
Standardize capitalization of "See also" sections
Rageking8 Jul 13, 2025
3de4bf0
Update metadata in 10 topics
Rageking8 Jul 13, 2025
dcd4480
Add blockquotes for error messages in range [C2101, C2120]
Rageking8 Jul 14, 2025
2b194ac
Add "Remarks" and "Example" headings for error references in range [C…
Rageking8 Jul 14, 2025
0f85397
Replace term "sample" with "example" for error references in range [C…
Rageking8 Jul 14, 2025
43e8603
Update metadata for error references in range [C2101, C2120]
Rageking8 Jul 14, 2025
049e07e
Add blockquotes for error messages in range [C2581, C2610]
Rageking8 Aug 1, 2025
1fcc773
Add "Remarks" and "Example" headings for error references in range [C…
Rageking8 Aug 1, 2025
812dbe0
Replace term "sample" with "example" for error references in range [C…
Rageking8 Aug 1, 2025
a2914fa
Update metadata for error references in range [C2581, C2610]
Rageking8 Aug 1, 2025
4058aac
Merge pull request #5538 from Rageking8/structure-error-references-in…
v-dirichards Aug 4, 2025
9bf691d
Merge pull request #5532 from Rageking8/standardize-capitalization-of…
v-dirichards Aug 4, 2025
fa87cf7
Merge pull request #5531 from Rageking8/structure-error-references-in…
v-dirichards Aug 4, 2025
786d385
Merge pull request #5528 from Rageking8/structure-error-references-in…
v-dirichards Aug 4, 2025
c7c2bab
Merge pull request #5527 from Rageking8/add-some-missing-spaces-befor…
v-dirichards Aug 4, 2025
4b79e18
Merge pull request #5526 from Rageking8/convert-math-errors-list-into…
v-dirichards Aug 4, 2025
857ae18
Merge pull request #5609 from Rageking8/structure-error-references-in…
v-dirichards Aug 4, 2025
de74ad0
Merge pull request #6031 from MicrosoftDocs/FromPublicMasterBranch
Albertyang0 Aug 4, 2025
e046d51
Merge pull request #6032 from MicrosoftDocs/main
learn-build-service-prod[bot] Aug 4, 2025
5adce9f
Merge pull request #5620 from MicrosoftDocs/main638899256670249768syn…
learn-build-service-prod[bot] Aug 4, 2025
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 3 additions & 4 deletions docs/assembler/masm/mmword.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
description: "Learn more about: MMWORD"
title: "MMWORD"
ms.date: "12/17/2019"
description: "Learn more about: MMWORD"
ms.date: 12/17/2019
f1_keywords: ["MMWORD"]
helpviewer_keywords: ["MMWORD directive"]
ms.assetid: b4c5a104-9078-4fb4-afc3-d1e63abe562a
---
# MMWORD

Expand Down Expand Up @@ -32,6 +31,6 @@ While both instructions work on 64-bit operands, **QWORD** is the type for 64-bi
movq mm0, mmword ptr [ebx]
```

## See Also
## See also

[MASM BNF Grammar](masm-bnf-grammar.md)
7 changes: 3 additions & 4 deletions docs/assembler/masm/xmmword.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
description: "Learn more about: XMMWORD"
title: "XMMWORD"
ms.date: "12/17/2019"
description: "Learn more about: XMMWORD"
ms.date: 12/17/2019
f1_keywords: ["XMMWORD"]
helpviewer_keywords: ["XMMWORD directive"]
ms.assetid: 18026d32-5cab-403e-ad7e-382fb41aa9b8
---
# XMMWORD

Expand All @@ -24,6 +23,6 @@ Used for 128-bit multimedia operands with MMX and SSE (XMM) instructions.
movdqa xmm0, xmmword ptr [ebx]
```

## See Also
## See also

[MASM BNF Grammar](masm-bnf-grammar.md)
4 changes: 2 additions & 2 deletions docs/build/reference/profile-performance-tools-profiler.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
description: "Learn more about: /PROFILE (Performance Tools Profiler)"
title: "/PROFILE (Performance Tools Profiler)"
description: "Learn more about: /PROFILE (Performance Tools Profiler)"
ms.date: 10/13/2021
f1_keywords: ["VC.Project.VCLinkerTool.Profile"]
helpviewer_keywords: ["-PROFILE linker option", "/PROFILE linker option"]
Expand Down Expand Up @@ -57,7 +57,7 @@ Because a **CMake** project doesn't have the usual **Property Pages** support, t

1. Rebuild your solution.

## See Also
## See also

[MSVC linker reference](linking.md)\
[MSVC linker options](linker-options.md)
10 changes: 5 additions & 5 deletions docs/c-runtime-library/crt-debugging-techniques.md
Original file line number Diff line number Diff line change
Expand Up @@ -18,15 +18,15 @@ When you debug a program that uses the C run-time library, these debugging techn

The C runtime (CRT) library provides extensive debugging support. To use one of the CRT debug libraries, you must link with [`/DEBUG`](/cpp/build/reference/debug-generate-debug-info) and compile with [`/MDd`, `/MTd`, or `/LDd`](../build/reference/md-mt-ld-use-run-time-library.md).

The main definitions and macros for CRT debugging can be found in the`<crtdbg.h>` header file.
The main definitions and macros for CRT debugging can be found in the `<crtdbg.h>` header file.

The functions in the CRT debug libraries are compiled with debug information ([/Z7, /Zd, /Zi, /ZI (Debug Information Format)](../build/reference/z7-zi-zi-debug-information-format.md)) and without optimization. Some functions contain assertions to verify parameters that are passed to them, and source code is provided. With this source code, you can step into CRT functions to confirm that the functions are working as you expect and check for bad parameters or memory states. (Some CRT technology is proprietary and doesn't provide source code for exception handling, floating point, and a few other routines.)

For more information on the various run-time libraries you can use, see [C Run-Time Libraries](./crt-library-features.md).

## Macros for reporting

For debugging, you can use the `_RPTn` and `_RPTFn` macros, defined in`<crtdbg.h>`, to replace the use of `printf` statements. You don't need to enclose them in `#ifdef` directives, because they automatically disappear in your release build when `_DEBUG` isn't defined.
For debugging, you can use the `_RPTn` and `_RPTFn` macros, defined in `<crtdbg.h>`, to replace the use of `printf` statements. You don't need to enclose them in `#ifdef` directives, because they automatically disappear in your release build when `_DEBUG` isn't defined.

| Macro | Description |
|---|---|
Expand Down Expand Up @@ -81,7 +81,7 @@ You can write several kinds of custom debug hook functions that allow you to ins

### Client block hook functions

If you want to validate or report the contents of the data stored in `_CLIENT_BLOCK` blocks, you can write a function specifically for this purpose. The function that you write must have a prototype similar to the following, as defined in`<crtdbg.h>`:
If you want to validate or report the contents of the data stored in `_CLIENT_BLOCK` blocks, you can write a function specifically for this purpose. The function that you write must have a prototype similar to the following, as defined in `<crtdbg.h>`:

```cpp
void YourClientDump(void *, size_t)
Expand All @@ -91,7 +91,7 @@ In other words, your hook function should accept a `void` pointer to the beginni

Once you've installed your hook function using [_CrtSetDumpClient](./reference/crtsetdumpclient.md), it will be called every time a `_CLIENT_BLOCK` block is dumped. You can then use [_CrtReportBlockType](./reference/crtreportblocktype.md) to get information on the type or subtype of dumped blocks.

The pointer to your function that you pass to `_CrtSetDumpClient` is of type `_CRT_DUMP_CLIENT`, as defined in`<crtdbg.h>`:
The pointer to your function that you pass to `_CrtSetDumpClient` is of type `_CRT_DUMP_CLIENT`, as defined in `<crtdbg.h>`:

```cpp
typedef void (__cdecl *_CRT_DUMP_CLIENT)
Expand All @@ -113,7 +113,7 @@ int YourAllocHook(int nAllocType, void *pvData,
const unsigned char * szFileName, int nLine )
```

The pointer that you pass to [`_CrtSetAllocHook`](./reference/crtsetallochook.md) is of type `_CRT_ALLOC_HOOK`, as defined in`<crtdbg.h>`:
The pointer that you pass to [`_CrtSetAllocHook`](./reference/crtsetallochook.md) is of type `_CRT_ALLOC_HOOK`, as defined in `<crtdbg.h>`:

```cpp
typedef int (__cdecl * _CRT_ALLOC_HOOK)
Expand Down
2 changes: 1 addition & 1 deletion docs/code-quality/c28112.md
Original file line number Diff line number Diff line change
Expand Up @@ -35,7 +35,7 @@ InterlockedDecrement(&inter_var);
InterlockedIncrement(&inter_var);
```

## See Also
## See also

[InterlockedIncrement function (wdm.h)](/windows-hardware/drivers/ddi/wdm/nf-wdm-interlockedincrement)\
[InterlockedDecrement function (wdm.h)](/windows-hardware/drivers/ddi/wdm/nf-wdm-interlockeddecrement)
5 changes: 2 additions & 3 deletions docs/code-quality/c6504.md
Original file line number Diff line number Diff line change
@@ -1,10 +1,9 @@
---
description: "Learn more about: Warning C6504"
title: Warning C6504
description: "Learn more about: Warning C6504"
ms.date: 10/03/2022
f1_keywords: ["C6504", "NULL_ON_NON_POINTER", "__WARNING_NULL_ON_NON_POINTER"]
helpviewer_keywords: ["C6504"]
ms.assetid: 6baeed46-e73d-4974-af16-7487c55b3473
---
# Warning C6504

Expand Down Expand Up @@ -60,6 +59,6 @@ void g(Point& pt)
}
```

## See Also
## See also

[Annotation Properties](using-sal-annotations-to-reduce-c-cpp-code-defects.md)
Original file line number Diff line number Diff line change
@@ -1,13 +1,12 @@
---
description: "Learn more about: Using SAL Annotations to Reduce C/C++ Code Defects"
title: Using SAL Annotations to Reduce C/C++ Code Defects
description: "Learn more about: Using SAL Annotations to Reduce C/C++ Code Defects"
ms.date: 11/04/2016
ms.topic: "concept-article"
helpviewer_keywords:
- "annotations"
- "SAL annotations"
- "code analysis, annotation"
ms.assetid: a16e47d0-6f3e-4ed6-8883-459b2874e9a4
---
# Using SAL Annotations to Reduce C/C++ Code Defects

Expand Down Expand Up @@ -47,6 +46,6 @@ The articles in this section of the documentation discuss aspects of SAL, provid

Provides examples that show how to use SAL annotations. Also explains common pitfalls.

## See Also
## See also

[SAL 2.0 Annotations for Windows Drivers](/windows-hardware/drivers/devtest/sal-2-annotations-for-windows-drivers)
4 changes: 2 additions & 2 deletions docs/cpp/import-export-module.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,9 @@
---
title: "module, import, export"
description: Use import and export declarations to access and to publish types and functions defined in the specified module.
ms.date: 02/13/2025
f1_keywords: ["module_cpp", "import_cpp", "export_cpp"]
helpviewer_keywords: ["modules [C++]", "modules [C++], import", "modules [C++], export"]
description: Use import and export declarations to access and to publish types and functions defined in the specified module.
---
# `module`, `import`, `export`

Expand Down Expand Up @@ -109,7 +109,7 @@ import // Always an identifier, never a keyword

**End Microsoft Specific**

## See Also
## See also

[Overview of modules in C++](modules-cpp.md)\
[Import the C++ standard library using modules](tutorial-import-stl-named-module.md)
13 changes: 8 additions & 5 deletions docs/error-messages/compiler-errors-1/compiler-error-c2041.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,21 @@
---
description: "Learn more about: Compiler Error C2041"
title: "Compiler Error C2041"
ms.date: "11/04/2016"
description: "Learn more about: Compiler Error C2041"
ms.date: 11/04/2016
f1_keywords: ["C2041"]
helpviewer_keywords: ["C2041"]
ms.assetid: c9a33bb1-f9cf-47d6-bd21-7d867a8c37d5
---
# Compiler Error C2041

illegal digit 'character' for base 'number'
> illegal digit 'character' for base 'number'

## Remarks

The specified character is not a valid digit for the base (such as octal or hex).

The following sample generates C2041:
## Example

The following example generates C2041:

```cpp
// C2041.cpp
Expand Down
13 changes: 8 additions & 5 deletions docs/error-messages/compiler-errors-1/compiler-error-c2042.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,21 @@
---
description: "Learn more about: Compiler Error C2042"
title: "Compiler Error C2042"
ms.date: "11/04/2016"
description: "Learn more about: Compiler Error C2042"
ms.date: 11/04/2016
f1_keywords: ["C2042"]
helpviewer_keywords: ["C2042"]
ms.assetid: e111788f-41ce-405a-9824-a4c1c26059e6
---
# Compiler Error C2042

signed/unsigned keywords mutually exclusive
> signed/unsigned keywords mutually exclusive

## Remarks

The keywords **`signed`** and **`unsigned`** are used in a single declaration.

The following sample generates C2042:
## Example

The following example generates C2042:

```cpp
// C2042.cpp
Expand Down
9 changes: 5 additions & 4 deletions docs/error-messages/compiler-errors-1/compiler-error-c2043.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,14 @@
---
description: "Learn more about: Compiler Error C2043"
title: "Compiler Error C2043"
ms.date: "11/04/2016"
description: "Learn more about: Compiler Error C2043"
ms.date: 11/04/2016
f1_keywords: ["C2043"]
helpviewer_keywords: ["C2043"]
ms.assetid: 6cc829f3-c6ea-43ae-8a3f-303ecf6c7dc6
---
# Compiler Error C2043

illegal break
> illegal break

## Remarks

A [break](../../cpp/break-statement-cpp.md) is legal only within a **`do`**, **`for`**, **`while`**, or **`switch`** statement.
9 changes: 5 additions & 4 deletions docs/error-messages/compiler-errors-1/compiler-error-c2044.md
Original file line number Diff line number Diff line change
@@ -1,13 +1,14 @@
---
description: "Learn more about: Compiler Error C2044"
title: "Compiler Error C2044"
ms.date: "11/04/2016"
description: "Learn more about: Compiler Error C2044"
ms.date: 11/04/2016
f1_keywords: ["C2044"]
helpviewer_keywords: ["C2044"]
ms.assetid: adf4bedc-f915-4008-8b48-a06d626d8c38
---
# Compiler Error C2044

illegal continue
> illegal continue

## Remarks

A [continue](../../cpp/continue-statement-cpp.md) is legal only within a **`do`**, **`for`**, or **`while`** statement.
13 changes: 8 additions & 5 deletions docs/error-messages/compiler-errors-1/compiler-error-c2045.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,21 @@
---
description: "Learn more about: Compiler Error C2045"
title: "Compiler Error C2045"
ms.date: "11/04/2016"
description: "Learn more about: Compiler Error C2045"
ms.date: 11/04/2016
f1_keywords: ["C2045"]
helpviewer_keywords: ["C2045"]
ms.assetid: 2fca668e-9b20-4933-987a-18c0fd0187df
---
# Compiler Error C2045

'identifier' : label redefined
> 'identifier' : label redefined

## Remarks

The label appears before multiple statements in the same function.

The following sample generates C2045:
## Example

The following example generates C2045:

```cpp
// C2045.cpp
Expand Down
13 changes: 8 additions & 5 deletions docs/error-messages/compiler-errors-1/compiler-error-c2046.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,21 @@
---
description: "Learn more about: Compiler Error C2046"
title: "Compiler Error C2046"
ms.date: "11/04/2016"
description: "Learn more about: Compiler Error C2046"
ms.date: 11/04/2016
f1_keywords: ["C2046"]
helpviewer_keywords: ["C2046"]
ms.assetid: f0c8f9dd-dbd7-4c4a-8838-fde54208ec71
---
# Compiler Error C2046

illegal case
> illegal case

## Remarks

The keyword `case` can appear only in a **`switch`** statement.

The following sample generates C2046:
## Example

The following example generates C2046:

```cpp
// C2046.cpp
Expand Down
13 changes: 8 additions & 5 deletions docs/error-messages/compiler-errors-1/compiler-error-c2047.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,21 @@
---
description: "Learn more about: Compiler Error C2047"
title: "Compiler Error C2047"
ms.date: "11/04/2016"
description: "Learn more about: Compiler Error C2047"
ms.date: 11/04/2016
f1_keywords: ["C2047"]
helpviewer_keywords: ["C2047"]
ms.assetid: 686a5a81-3857-4753-84a0-5c2e7149cbee
---
# Compiler Error C2047

illegal default
> illegal default

## Remarks

The keyword **`default`** can appear only in a **`switch`** statement.

The following sample generates C2047:
## Example

The following example generates C2047:

```cpp
// C2047.cpp
Expand Down
13 changes: 8 additions & 5 deletions docs/error-messages/compiler-errors-1/compiler-error-c2048.md
Original file line number Diff line number Diff line change
@@ -1,18 +1,21 @@
---
description: "Learn more about: Compiler Error C2048"
title: "Compiler Error C2048"
ms.date: "11/04/2016"
description: "Learn more about: Compiler Error C2048"
ms.date: 11/04/2016
f1_keywords: ["C2048"]
helpviewer_keywords: ["C2048"]
ms.assetid: 44704726-85fc-42f0-afb9-194df8c4ca7c
---
# Compiler Error C2048

more than one default
> more than one default

## Remarks

A **`switch`** statement contains multiple **`default`** labels. Delete one of the **`default`** labels to resolve the error.

The following sample generates C2048:
## Example

The following example generates C2048:

```cpp
// C2048.cpp
Expand Down
Loading