Skip to content

Commit 78a590e

Browse files
author
Colin Robertson
committed
Update language for /std:c++latest, add note
1 parent 7aa2f31 commit 78a590e

File tree

1 file changed

+6
-3
lines changed

1 file changed

+6
-3
lines changed

docs/build/reference/std-specify-language-standard-version.md

Lines changed: 6 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -10,11 +10,11 @@ Enable supported C++ language features from the specified version of the C++ lan
1010

1111
## Syntax
1212

13-
> /std:[c++14|c++17|c++latest]
13+
> /std:\[c++14\|c++17\|c++latest]
1414
1515
## Remarks
1616

17-
The **/std** option is available in Visual Studio 2017 and later. It is used to control the version-specific ISO C++ programming language standard features enabled during compilation of your code. This option allows you to disable support for certain new language and library features that may break your existing code that conforms to a particular version of the language standard. By default, **/std:c++14** is specified, which disables language and standard library features found in later versions of the C++ language standard. Use **/std:c++17** to enable C++17 standard-specific features and behavior. To explicitly enable the latest supported compiler and standard library features, use **/std:c++latest**.
17+
The **/std** option is available in Visual Studio 2017 and later. It is used to control the version-specific ISO C++ programming language standard features enabled during compilation of your code. This option allows you to disable support for certain new language and library features that may break your existing code that conforms to a particular version of the language standard. By default, **/std:c++14** is specified, which disables language and standard library features found in later versions of the C++ language standard. Use **/std:c++17** to enable C++17 standard-specific features and behavior. To explicitly enable the currently implemented compiler and standard library features proposed for the next draft standard, use **/std:c++latest**.
1818

1919
The default **/std:c++14** option enables the set of C++14 features implemented by the Visual C++ compiler. This option disables compiler and standard library support for features that are changed or new in more recent versions of the language standard, with the exception of some C++17 features already implemented in previous releases of the Visual C++ compiler. To avoid breaking changes for users who have already taken dependencies on the features available as of Visual Studio 2015 Update 2, these features remain enabled when the **/std:c++14** option is specified:
2020

@@ -32,7 +32,10 @@ For additional information on which C++14 and C++17 features are enabled when **
3232

3333
The **/std:c++17** option enables the full set of C++17 features implemented by the Visual C++ compiler. This option disables compiler and standard library support for features that are changed or new in versions of the Working Draft and defect updates of the C++ Standard after C++17.
3434

35-
The **/std:c++latest** option enables the set of C++ language and library features implemented by Visual C++ to track the most recent C++20 Working Draft and defect updates of the C++ Standard that are not included in C++17. Use this switch to get the post-C++17 language features supported by the compiler and standard library. For a list of supported language and library features, see [What's New for Visual C++](../../what-s-new-for-visual-cpp-in-visual-studio.md). The **/std:c++latest** option does not enable features guarded by the **/experimental** switch.
35+
The **/std:c++latest** option enables the post-C++17 language and library features currently implemented in the compiler and libraries. These may include features from the C++20 Working Draft and defect updates of the C++ Standard that are not included in C++17, as well as experimental proposals for the draft standard. For a list of supported language and library features, see [What's New for Visual C++](../../what-s-new-for-visual-cpp-in-visual-studio.md). The **/std:c++latest** option does not enable features guarded by the **/experimental** switch, but may be required to enable them.
36+
37+
> [!IMPORTANT]
38+
> The compiler and library features enabled by **/std:c++latest** are provided as-is and without support. They are subject to breaking changes or removal without notice. They are intended as a preview of language features that may appear in the next version of the standard, but the standard is a work in progress. Use **/std:c++17** to use the features in the latest ISO C++ standard.
3639
3740
The **/std** option in effect during a C++ compilation can be detected by use of the [\_MSVC\_LANG](../../preprocessor/predefined-macros.md) preprocessor macro. For more information, see [Preprocessor Macros](../../preprocessor/predefined-macros.md).
3841

0 commit comments

Comments
 (0)