Skip to content

Commit 01c0454

Browse files
colin-homecolin-home
authored
Merge pull request MicrosoftDocs#4829 from corob-msft/learn/corob/17.5-updates
Update with changes for VS 17.5
2 parents 1c8aa66 + a33fc6e commit 01c0454

12 files changed

+273
-36
lines changed

‎docs/build/building-on-the-command-line.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -147,7 +147,7 @@ When used with no arguments, *`vcvarsall.bat`* configures the environment variab
147147

148148
### `vcvarsall` syntax
149149

150-
> **`vcvarsall.bat`** [*`architecture`*] [*`platform_type`*] [*`winsdk_version`*] [**`-vcvars_ver=`**_`vcversion`_] [*`spectre_mode`*]
150+
> **`vcvarsall.bat`** [*`architecture`*] [*`platform_type`*] [*`winsdk_version`*] [**`-vcvars_ver=`***`vcversion`*] [*`spectre_mode`*]
151151
152152
*`architecture`*<br/>
153153
This optional argument specifies the host and target architecture to use. If *architecture* isn't specified, the default build environment is used. These arguments are supported:

‎docs/error-messages/compiler-errors-2/compiler-error-c7688.md

Lines changed: 44 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,44 @@
1+
---
2+
title: "Compiler error C7688"
3+
description: Compiler error C7688 description and solution.
4+
ms.date: 03/01/2023
5+
f1_keywords: ["C7688"]
6+
helpviewer_keywords: ["C7688"]
7+
---
8+
# Compiler error C7688
9+
10+
> '`pragma omp atomic`': expected an expression of scalar type
11+
12+
## Remarks
13+
14+
OpenMP restricts expressions in `#pragma omp atomic` constructs to scalar type.
15+
16+
Compiler error C7688 is new in Visual Studio 2022 version 17.4. In previous compiler versions, the compiler would emit error [C3048](./compiler-error-c3048.md).
17+
18+
## Example
19+
20+
The sample code shows diagnostics generated for non-scalar types in `#pragma omp atomic` constructs.
21+
22+
```cpp
23+
// C7688.cpp
24+
// compile using /c /openmp:llvm
25+
struct S { char c; };
26+
S operator+(S, int);
27+
28+
void test()
29+
{
30+
S s1, s2;
31+
#pragma omp atomic capture
32+
{ s1 = s2; s2 = s1 + 1; }
33+
}
34+
/*
35+
When built, the compiler emits:
36+
37+
.\C7688.cpp(10,10): error C7688: '#pragma omp atomic': expected an expression of scalar type
38+
{ s1 = s2; s2 = s1 + 1; }
39+
^
40+
.\C7688.cpp(10,10): note: type is 'S'
41+
*/
42+
```
43+
44+
To resolve this issue, use scalar types in `#pragma omp atomic` constructs.

‎docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -177,6 +177,7 @@ The articles in this section of the documentation explain a subset of the error
177177
| Compiler error C7660 | '%s': requires '%s' command line option(s) |
178178
| Compiler error C7661 | header-name '%s' has an ambiguous resolution to header '%s' |
179179
| Compiler error C7662 | '%$S': a coroutine cannot be constexpr or consteval |
180+
| [Compiler error C7688](compiler-error-c7688.md) | '`#pragma omp atomic`': expected an expression of scalar type |
180181
| Compiler error C7700 | type '%$T' in _Generic association compatible with previous association type '%$T' |
181182
| Compiler error C7701 | default _Generic association previously specified |
182183
| Compiler error C7702 | no compatible type for '%$T' in _Generic association list |

‎docs/error-messages/compiler-warnings/c5262.md

Lines changed: 60 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,60 @@
1+
---
2+
title: "Compiler warning (level 1, error, off) C5262"
3+
description: Compiler warning C5262 description and solution.
4+
ms.date: 03/01/2023
5+
f1_keywords: ["C5262"]
6+
helpviewer_keywords: ["C5262"]
7+
---
8+
# Compiler warning (level 1, error, off) C5262
9+
10+
> implicit fall-through occurs here; are you missing a `break` statement? Use `[[fallthrough]]` when a `break` statement is intentionally omitted between cases
11+
12+
## Remarks
13+
14+
Control flow that implicitly falls between cases of switch statements is a historical source of bugs for both C and C++. While we had the `__fallthrough` SAL macro, it wasn't useful for the build-compiler diagnostics. Since customers have legacy code that "falls through" on purpose, it isn't viable to give an actionable warning without some way of indicating an intentional fall through. In C++17, the `[[fallthrough]]` attribute was added to indicate such an instance. The compiler can take this attribute into account and suppress the new warning.
15+
16+
Compiler warning C5262 is new in Visual Studio 2022 version 17.4, and is both off by default and treated as an error by default when enabled. To continue to support legacy code without build breaks, C5262 must be explicitly enabled. For more information on how to enable this warning, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md).
17+
18+
## Example
19+
20+
The sample code shows diagnostics for `switch` cases that fall through without `break` or `return` statements or the `[[fallthrough]]` attribute.
21+
22+
```cpp
23+
// C5262.cpp
24+
// compile using /std:c++17 /we5262
25+
26+
int main(int argc, char** argv)
27+
{
28+
switch (argc)
29+
{
30+
case 0: ++argv;
31+
case 1:
32+
case 2: argv++;
33+
default:
34+
argv = 0;
35+
}
36+
}
37+
38+
/*
39+
When built, the compiler produces this output:
40+
41+
.\C5262.cpp(9,9): error C5262: implicit fall-through occurs here; are you missing a break statement? Use [[fallthrough]] when a break statement is intentionally omitted between cases
42+
case 1:
43+
^
44+
.\C5262.cpp(8,17): note: statement that may fall through is here
45+
case 0: ++argv;
46+
^
47+
.\C5262.cpp(11,9): error C5262: implicit fall-through occurs here; are you missing a break statement? Use [[fallthrough]] when a break statement is intentionally omitted between cases
48+
default:
49+
^
50+
.\C5262.cpp(10,17): note: statement that may fall through is here
51+
case 2: argv++;
52+
*/
53+
```
54+
55+
To resolve this issue when the control flow between cases is intentional, use the `[[fallthrough]]` attribute.
56+
57+
## See also
58+
59+
[`switch` statement (C++)](../../cpp/switch-statement-cpp.md)\
60+
[`[[fallthrough]]` attribute](../../cpp/attributes.md#fallthrough)

‎docs/error-messages/compiler-warnings/c5301-c5302.md

Lines changed: 48 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,48 @@
1+
---
2+
title: "Compiler warnings (level 1) C5301 and C5302"
3+
description: Compiler warnings C5301 and C5302 description and solution.
4+
ms.date: 03/01/2023
5+
f1_keywords: ["C5301", "C5302"]
6+
helpviewer_keywords: ["C5301", "C5302"]
7+
---
8+
# Compiler warnings (level 1) C5301 and C5302
9+
10+
> '`#pragma omp for`': '*loop-index*' increases while loop condition uses '*comparison*'; non-terminating loop?
11+
12+
> '`#pragma omp for`': '*loop-index*' decreases while loop condition uses '*comparison*'; non-terminating loop?
13+
14+
## Remarks
15+
16+
Along with improved support for OpenMP 3.1, we've added two diagnostics, C5301 and C5302, to improve the developer experience. These diagnostics check that the loop conditions for `omp parallel for` are correct, based on whether the loop index variable is increasing or decreasing. These checks work for both integral and pointer indices.
17+
18+
These compiler warnings are new in Visual Studio 2022 version 17.4.
19+
20+
## Example
21+
22+
The sample code shows a diagnostic for a `for` loop that decrements the index, but it uses a `<=` comparison that tests whether the index is less than a value higher than the starting value.
23+
24+
```C
25+
// C5302.c
26+
// compile using /openmp
27+
28+
#include <stdio.h>
29+
30+
int main()
31+
{
32+
int a[100], i;
33+
int k = 1;
34+
#pragma omp parallel for
35+
for (i = 0; i <= 100; i--)
36+
a[i] = i*i;
37+
}
38+
39+
/*
40+
Compiler warning message:
41+
42+
.\C5302.c(11,19): warning C5302: '#pragma omp for': 'i' decreases while loop condition uses '<='; non-terminating loop?
43+
for (i = 0; i <= 100; i--)
44+
^
45+
*/
46+
```
47+
48+
To resolve this issue, change the test condition or the direction of the index change to one that terminates without causing overflow, underflow, or other undefined behavior.

‎docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "Compiler Warnings by compiler version"
33
description: "Table of Microsoft C/C++ compiler warnings by compiler version."
4-
ms.date: 11/07/2022
4+
ms.date: 02/28/2023
55
helpviewer_keywords: ["warnings, by compiler version", "cl.exe compiler, setting warning options"]
66
---
77
# Compiler Warnings by compiler version
@@ -47,13 +47,23 @@ These versions of the compiler introduced new warnings:
4747
| Visual Studio 2022 version 17.2 | 19.32 |
4848
| Visual Studio 2022 version 17.3 | 19.33 |
4949
| Visual Studio 2022 version 17.4 | 19.34 |
50+
| Visual Studio 2022 version 17.5 | 19.35 |
5051

5152
You can specify only the major number, the major and minor numbers, or the major, minor, and build numbers to the **`/Wv`** option. The compiler reports all warnings that match versions that begin with the specified number. It suppresses all warnings for versions greater than the specified number. For example, **`/Wv:17`** reports warnings introduced in or before any version of Visual Studio 2012, and suppresses warnings introduced by any compiler from Visual Studio 2013 (version 18) or later. To suppress warnings introduced in Visual Studio 2015 update 2 and later, you can use **`/Wv:19.00.23506`**. Use **`/Wv:19.11`** to report the warnings introduced in any version of Visual Studio before Visual Studio 2017 version 15.5, but suppress warnings introduced in Visual Studio 2017 version 15.5 and later.
5253

5354
The following sections list the warnings introduced by each version of Visual C++ that you can suppress by using the **`/Wv`** compiler option. The **`/Wv`** option can't suppress warnings that aren't listed, which predate the specified versions of the compiler.
5455

5556
::: moniker range=">= msvc-170"
5657

58+
## Warnings introduced in Visual Studio 2022 version 17.5 (compiler version 19.35)
59+
60+
These warnings and all warnings in later versions are suppressed by using the compiler option **`/Wv:19.34`**.
61+
62+
| Warning | Message |
63+
|--|--|
64+
| C5082 | second argument to '`va_start`' is not the last named parameter |
65+
| C5265 | cannot open search path '*pathname*' |
66+
5767
## Warnings introduced in Visual Studio 2022 version 17.4 (compiler version 19.34)
5868

5969
These warnings and all warnings in later versions are suppressed by using the compiler option **`/Wv:19.33`**.

‎docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
22
title: "Compiler warnings C4800 Through C5999"
33
description: "Table of Microsoft C/C++ compiler warnings C4800 through C5999."
4-
ms.date: 11/07/2022
5-
f1_keywords: ["C4808", "C4809", "C4825", "C4827", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4854", "C4855", "C4856", "C4857", "C4872", "C4880", "C4881", "C4882", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998", "C5022", "C5023", "C5024", "C5025", "C5026", "C5027", "C5028", "C5029", "C5030", "C5031", "C5032", "C5034", "C5035", "C5036", "C5039", "C5040", "C5041", "C5042", "C5043", "C5044", "C5047", "C5048", "C5049", "C5051", "C5052", "C5053", "C5057", "C5058", "C5059", "C5060", "C5061", "C5062", "C5063", "C5081", "C5100", "C5101", "C5102", "C5103", "C5104", "C5106", "C5107", "C5108", "C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5211", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5262", "C5263", "C5264", "C5300", "C5301", "C5302"]
6-
helpviewer_keywords: ["C4808", "C4809", "C4825", "C4827", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4854", "C4855", "C4856", "C4857", "C4872", "C4880", "C4881", "C4882", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998", "C5022", "C5023", "C5024", "C5025", "C5026", "C5027", "C5028", "C5029", "C5030", "C5031", "C5032", "C5034", "C5035", "C5036", "C5039", "C5040", "C5041", "C5042", "C5043", "C5044", "C5047", "C5048", "C5049", "C5051", "C5052", "C5053", "C5057", "C5058", "C5059", "C5060", "C5061", "C5062", "C5063", "C5081", "C5100", "C5101", "C5102", "C5103", "C5104", "C5106", "C5107", "C5108", "C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5211", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5262", "C5263", "C5264", "C5300", "C5301", "C5302"]
4+
ms.date: 03/01/2023
5+
f1_keywords: ["C4808", "C4809", "C4825", "C4827", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4854", "C4855", "C4856", "C4857", "C4872", "C4880", "C4881", "C4882", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998", "C5022", "C5023", "C5024", "C5025", "C5026", "C5027", "C5028", "C5029", "C5030", "C5031", "C5032", "C5034", "C5035", "C5036", "C5039", "C5040", "C5041", "C5042", "C5043", "C5044", "C5047", "C5048", "C5049", "C5051", "C5052", "C5053", "C5057", "C5058", "C5059", "C5060", "C5061", "C5062", "C5063", "C5081", "C5100", "C5101", "C5102", "C5103", "C5104", "C5106", "C5107", "C5108", "C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5211", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5300"]
6+
helpviewer_keywords: ["C4808", "C4809", "C4825", "C4827", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4854", "C4855", "C4856", "C4857", "C4872", "C4880", "C4881", "C4882", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998", "C5022", "C5023", "C5024", "C5025", "C5026", "C5027", "C5028", "C5029", "C5030", "C5031", "C5032", "C5034", "C5035", "C5036", "C5039", "C5040", "C5041", "C5042", "C5043", "C5044", "C5047", "C5048", "C5049", "C5051", "C5052", "C5053", "C5057", "C5058", "C5059", "C5060", "C5061", "C5062", "C5063", "C5081", "C5100", "C5101", "C5102", "C5103", "C5104", "C5106", "C5107", "C5108", "C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5211", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5300"]
77
---
88
# Compiler warnings C4800 through C5999
99

@@ -244,12 +244,12 @@ The articles in this section of the documentation explain a subset of the warnin
244244
| Compiler warning (level 4, off) C5259 | '*specialized-type*': explicit specialization requires 'template <>' |
245245
| Compiler warning (level 1) C5260 | the constant variable '*variable-name*' has internal linkage in an included header file context, but external linkage in imported header unit context; consider declaring it 'inline' as well if it will be shared across translation units, or 'static' to express intent to use it local to this translation unit |
246246
| Compiler warning (level 2) C5261 | no integer type can represent all enumerator values in enumeration '*enum-name*' |
247-
| Compiler warning (level 1, off) C5262 | implicit fall-through occurs here; are you missing a break statement? Use `[[fallthrough]]` when a `break` statement is intentionally omitted between cases |
247+
| [Compiler warning (level 1, error, off) C5262](c5262.md) | implicit fall-through occurs here; are you missing a break statement? Use `[[fallthrough]]` when a `break` statement is intentionally omitted between cases |
248248
| Compiler warning (level 4, off) C5263 | calling '`std::move`' on a temporary object prevents copy elision |
249249
| Compiler warning (level 4, off) C5264 | '*variable-name*': 'const' variable is not used |
250250
| Compiler warning (level 1, error) C5300 | '#pragma omp atomic': left operand of '*operator*' must match left hand side of assignment-expression |
251-
| Compiler warning (level 1) C5301 | '#pragma omp for': '*symbol*' increases while loop condition uses '*comparison*'; non-terminating loop? |
252-
| Compiler warning (level 1) C5302 | '#pragma omp for': '*symbol*' decreases while loop condition uses '*comparison*'; non-terminating loop? |
251+
| [Compiler warning (level 1) C5301](c5301-c5302.md) | '#pragma omp for': '*loop-index*' increases while loop condition uses '*comparison*'; non-terminating loop? |
252+
| [Compiler warning (level 1) C5302](c5301-c5302.md) | '#pragma omp for': '*loop-index*' decreases while loop condition uses '*comparison*'; non-terminating loop? |
253253

254254
## See also
255255

‎docs/error-messages/toc.yml

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4361,6 +4361,10 @@ items:
43614361
href: compiler-warnings/c5247.md
43624362
- name: Compiler warning (level 1) C5248
43634363
href: compiler-warnings/c5248.md
4364+
- name: Compiler warning (level 1, error, off) C5262
4365+
href: compiler-warnings/c5262.md
4366+
- name: Compiler warning (level 1) C5301 and C5302
4367+
href: compiler-warnings/c5301-c5302.md
43644368
- name: Compiler warnings by compiler version
43654369
href: compiler-warnings/compiler-warnings-by-compiler-version.md
43664370
- name: Compiler warnings that are off by default

‎docs/overview/cpp-conformance-improvements.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,12 @@
11
---
22
title: "C++ conformance improvements in Visual Studio 2022"
33
description: "Microsoft C++ in Visual Studio is improving standards conformance and fixing bugs regularly."
4-
ms.date: 08/08/2022
4+
ms.date: 03/01/2023
55
ms.technology: "cpp-language"
66
---
77
# C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022
88

9-
Microsoft C/C++ in Visual Studio (MSVC) makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use the list below **In this article**.
9+
Microsoft C/C++ in Visual Studio (MSVC) makes conformance improvements and bug fixes in every release. This article lists the significant improvements by major release, then by version. To jump directly to the changes for a specific version, use the list below **In this article**.
1010

1111
This document lists the changes in Visual Studio 2022. For a guide to the changes in Visual Studio 2019, see [C++ conformance improvements in Visual Studio 2019](cpp-conformance-improvements-2019.md). For changes in Visual Studio 2017, see [C++ conformance improvements in Visual Studio 2017](cpp-conformance-improvements-2017.md). For a complete list of previous conformance improvements, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md).
1212

0 commit comments

Comments
 (0)