Merge pull request #5752 from MicrosoftDocs/FromPublicMasterBranch

Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main)

Author: v-alje

docs/build/creating-precompiled-header-files.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: Precompiled header files"
 title: "Precompiled Header Files"
+description: "Learn more about: Precompiled header files"
 ms.date: 06/29/2022
 helpviewer_keywords: ["precompiled header files, creating", "PCH files, creating", "cl.exe compiler, precompiling code", ".pch files, creating"]
 ---
@@ -259,7 +259,7 @@ Source file `ANOTHER.H`:
 //
 #ifndef __ANOTHER_H
 #define __ANOTHER_H
-#include<iostream>
+#include <iostream>
 void savemoretime( void );
 #endif // __ANOTHER_H
 ```
@@ -273,7 +273,7 @@ Source file `STABLE.H`:
 //
 #ifndef __STABLE_H
 #define __STABLE_H
-#include<iostream>
+#include <iostream>
 void savetime( void );
 #endif // __STABLE_H
 ```
@@ -289,7 +289,7 @@ Source file `UNSTABLE.H`:
 //
 #ifndef __UNSTABLE_H
 #define __UNSTABLE_H
-#include<iostream>
+#include <iostream>
 void notstable( void );
 #endif // __UNSTABLE_H
 ```
@@ -301,9 +301,9 @@ Source file `APPLIB.CPP`:
 //              the interface code declared in the header
 //              files STABLE.H, ANOTHER.H, and UNSTABLE.H.
 //
-#include"another.h"
-#include"stable.h"
-#include"unstable.h"
+#include "another.h"
+#include "stable.h"
+#include "unstable.h"
 using namespace std;
 // The following code represents code that is deemed stable and
 // not likely to change. The associated interface code is
@@ -331,9 +331,9 @@ Source file `MYAPP.CPP`:
 //             listed in the BOUNDRY macro. Unstable code must
 //             be included after the precompiled code.
 //
-#include"another.h"
-#include"stable.h"
-#include"unstable.h"
+#include "another.h"
+#include "stable.h"
+#include "unstable.h"
 int main( void )
 {
     savetime();

docs/c-runtime-library/reference/abort.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: abort"
 title: "abort"
+description: "Learn more about: abort"
 ms.date: 07/07/2022
 api_name: ["abort", "_o_abort"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-runtime-l1-1-0.dll"]
@@ -71,8 +71,8 @@ The following program tries to open a file and aborts if the attempt fails.
 // the abort function by attempting to open a file
 // and aborts if the attempt fails.
 
-#include  <stdio.h>
-#include  <stdlib.h>
+#include <stdio.h>
+#include <stdlib.h>
 
 int main( void )
 {

docs/c-runtime-library/reference/access-waccess.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: _access, _waccess"
 title: "_access, _waccess"
+description: "Learn more about: _access, _waccess"
 ms.date: "4/2/2020"
 api_name: ["_access", "_waccess", "t_access", "_o__access", "_o__waccess"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"]
@@ -90,9 +90,9 @@ The following example uses **`_access`** to check the file named *`crt_ACCESS.C`
 // This example uses _access to check the file named
 // crt_ACCESS.C to see if it exists and if writing is allowed.
 
-#include  <io.h>
-#include  <stdio.h>
-#include  <stdlib.h>
+#include <io.h>
+#include <stdio.h>
+#include <stdlib.h>
 
 int main( void )
 {

docs/c-runtime-library/reference/dupenv-s-dbg-wdupenv-s-dbg.md

@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: _dupenv_s_dbg, _wdupenv_s_dbg"
 title: "_dupenv_s_dbg, _wdupenv_s_dbg"
+description: "Learn more about: _dupenv_s_dbg, _wdupenv_s_dbg"
 ms.date: "11/04/2016"
 api_name: ["_dupenv_s_dbg", "_wdupenv_s_dbg"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"]
 api_type: ["DLLExport"]
 topic_type: ["apiref"]
 f1_keywords: ["_tdupenv_s_dbg", "_dupenv_s_dbg", "_wdupenv_s_dbg"]
 helpviewer_keywords: ["_tdupenv_s_dbg function", "dupenv_s_dbg function", "_wdupenv_s_dbg function", "environment variables", "tdupenv_s_dbg function", "wdupenv_s_dbg function", "_dupenv_s_dbg function"]
-ms.assetid: e3d81148-e24e-46d0-a21d-fd87b5e6256c
 ---
 # `_dupenv_s_dbg`, `_wdupenv_s_dbg`
 
@@ -88,7 +87,7 @@ For more compatibility information, see [Compatibility](../compatibility.md).
 
 ```C
 // crt_dupenv_s_dbg.c
-#include  <stdlib.h>
+#include <stdlib.h>
 #include <crtdbg.h>
 
 int main( void )

docs/c-runtime-library/reference/dupenv-s-wdupenv-s.md

@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: _dupenv_s, _wdupenv_s"
 title: "_dupenv_s, _wdupenv_s"
+description: "Learn more about: _dupenv_s, _wdupenv_s"
 ms.date: "4/2/2020"
 api_name: ["_dupenv_s", "_wdupenv_s", "_o__dupenv_s", "_o__wdupenv_s"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-environment-l1-1-0.dll"]
 api_type: ["DLLExport"]
 topic_type: ["apiref"]
 f1_keywords: ["tdupenv_s", "_dupenv_s", "wdupenv_s", "dupenv_s", "_tdupenv_s", "_wdupenv_s"]
 helpviewer_keywords: ["_dupenv_s function", "_tdupenv_s function", "_wdupenv_s function", "environment variables", "wdupenv_s function", "dupenv_s function", "tdupenv_s function"]
-ms.assetid: b729ecc2-a31d-4ccf-92a7-5accedb8f8c8
 ---
 # `_dupenv_s`, `_wdupenv_s`
 
@@ -89,7 +88,7 @@ For more compatibility information, see [Compatibility](../compatibility.md).
 
 ```C
 // crt_dupenv_s.c
-#include  <stdlib.h>
+#include <stdlib.h>
 
 int main( void )
 {

docs/c-runtime-library/reference/strncnt-wcsncnt-mbsnbcnt-mbsnbcnt-l-mbsnccnt-mbsnccnt-l.md

@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: _strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l"
 title: "_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l"
+description: "Learn more about: _strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l"
 ms.date: "4/2/2020"
 api_name: ["_mbsnbcnt_l", "_mbsnccnt", "_wcsncnt", "_strncnt", "_mbsnccnt_l", "_mbsnbcnt", "_o__mbsnbcnt", "_o__mbsnbcnt_l", "_o__mbsnccnt", "_o__mbsnccnt_l"]
 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-multibyte-l1-1-0.dll"]
 api_type: ["DLLExport"]
 topic_type: ["apiref"]
 f1_keywords: ["_mbsnbcnt", "wcsncnt", "_tcsnbcnt", "_mbsnccnt", "_ftcsnbcnt", "mbsnbcnt", "strncnt", "mbsnbcnt_l", "mbsnccnt_l", "mbsnccnt", "_strncnt", "_wcsncnt"]
 helpviewer_keywords: ["_strncnt function", "_mbsnbcnt function", "_mbsnbcnt_l function", "_mbsnccnt_l function", "mbsnbcnt_l function", "mbsnbcnt function", "tcsnbcnt function", "mbsnccnt_l function", "strncnt function", "_tcsnbcnt function", "mbsnccnt function", "wcsncnt function", "_mbsnccnt function", "_wcsncnt function"]
-ms.assetid: 2a022e9e-a307-4acb-a66b-e56e5357f848
 ---
 # `_strncnt`, `_wcsncnt`, `_mbsnbcnt`, `_mbsnbcnt_l`, `_mbsnccnt`, `_mbsnccnt_l`
 
@@ -105,8 +104,8 @@ For more compatibility information, see [Compatibility](../compatibility.md).
 ```C
 // crt_mbsnbcnt.c
 
-#include  <mbstring.h>
-#include  <stdio.h>
+#include <mbstring.h>
+#include <stdio.h>
 
 int main( void )
 {

docs/code-quality/c6506.md

@@ -1,10 +1,9 @@
 ---
-description: "Learn more about: Warning C6506"
 title: Warning C6506
+description: "Learn more about: Warning C6506"
 ms.date: 11/04/2016
 f1_keywords: ["C6506", "BUFFER_SIZE_ON_NON_POINTER_OR_ARRAY", "__WARNING_BUFFER_SIZE_ON_NON_POINTER_OR_ARRAY"]
 helpviewer_keywords: ["C6506"]
-ms.assetid: 20b87ee8-13ea-4d71-95a1-2b2d144d196a
 ---
 # Warning C6506
 
@@ -21,7 +20,7 @@ Code analysis name: `BUFFER_SIZE_ON_NON_POINTER_OR_ARRAY`
 The following code generates this warning:
 
 ```cpp
-#include<sal.h>
+#include <sal.h>
 void f(_Out_ char c)
 {
     c = 'd';
@@ -31,7 +30,7 @@ void f(_Out_ char c)
 To correct this warning, use a pointer or an array type, as shown in the following sample code:
 
 ```cpp
-#include<sal.h>
+#include <sal.h>
 void f(_Out_ char *c)
 {
     *c = 'd';

docs/dotnet/how-to-access-characters-in-a-system-string.md

@@ -1,10 +1,9 @@
 ---
-description: "Learn more about: How to: Access Characters in a System::String"
 title: "How to: Access Characters in a System::String"
+description: "Learn more about: How to: Access Characters in a System::String"
 ms.custom: "get-started-article"
 ms.date: "11/04/2016"
 helpviewer_keywords: ["characters [C++], accessing in System::String", "examples [C++], strings", "strings [C++], accessing characters"]
-ms.assetid: cfc89756-aef3-4988-907e-fb236dcb7087
 ---
 # How to: Access Characters in a System::String
 
@@ -21,7 +20,7 @@ If you pass `ppchar` to a native function, then it must be a pinning pointer; th
 ```cpp
 // PtrToStringChars.cpp
 // compile with: /clr
-#include<vcclr.h>
+#include <vcclr.h>
 using namespace System;
 
 int main() {

docs/dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md

@@ -3,7 +3,6 @@ title: "How to: Define and consume classes and structs (C++/CLI)"
 description: "How to create and use user-defined class and struct types in C++/CLI code."
 ms.date: 09/25/2020
 helpviewer_keywords: ["structs [C++]", "classes [C++], instantiating"]
-ms.assetid: 1c03cb0d-1459-4b5e-af65-97d6b3094fd7
 ---
 # How to: Define and consume classes and structs (C++/CLI)
 
@@ -636,7 +635,7 @@ The following sample demonstrates when a copy constructor isn't generated.
 
 ```cpp
 // compile with: /clr
-#include<stdio.h>
+#include <stdio.h>
 
 struct S {
    int i;

docs/error-messages/compiler-errors-1/compiler-error-c2006.md

@@ -1,28 +1,22 @@
 ---
-description: "Learn more about: Compiler Error C2006"
 title: "Compiler Error C2006"
-ms.date: "11/04/2016"
+description: "Learn more about: Compiler Error C2006"
+ms.date: "01/28/2025"
 f1_keywords: ["C2006"]
 helpviewer_keywords: ["C2006"]
-ms.assetid: caaed6f7-ceb9-4742-8820-d66657c0b04d
 ---
 # Compiler Error C2006
 
-'directive' expected a filename, found 'token'
+'directive': expected "FILENAME" or \<FILENAME>
 
-Directives such as [#include](../../preprocessor/hash-include-directive-c-cpp.md) or [#import](../../preprocessor/hash-import-directive-cpp.md) require a filename. To resolve the error, make sure *token* is a valid filename. Also, put the filename in double quotes or angle brackets.
+Directives such as [#include](../../preprocessor/hash-include-directive-c-cpp.md) or [#import](../../preprocessor/hash-import-directive-cpp.md) require a filename. To resolve the error, ensure the filename is valid and enclosed in either double quotes or angle brackets.
 
 The following sample generates C2006:
 
 ```cpp
 // C2006.cpp
-#include stdio.h   // C2006
-```
-
-Possible resolution:
-
-```cpp
-// C2006b.cpp
 // compile with: /c
-#include <stdio.h>
+#include iostream     // C2006
+#include 'iostream'   // C2006
+#include <iostream>   // OK
 ```

docs/error-messages/compiler-errors-2/compiler-error-c2893.md

@@ -1,10 +1,9 @@
 ---
-description: "Learn more about: Compiler Error C2893"
 title: "Compiler Error C2893"
+description: "Learn more about: Compiler Error C2893"
 ms.date: "11/04/2016"
 f1_keywords: ["C2893"]
 helpviewer_keywords: ["C2893"]
-ms.assetid: ec0cbe43-005d-45da-8742-aaeb9b81d28e
 ---
 # Compiler Error C2893
 
@@ -21,7 +20,7 @@ C2893 occurs because `f`'s template parameter `T` is deduced to be `std::map<int
 ```cpp
 // C2893.cpp
 // compile with: /c /EHsc
-#include<map>
+#include <map>
 using namespace std;
 class MyClass {};
 

docs/error-messages/compiler-errors-2/compiler-error-c3867.md

@@ -1,10 +1,9 @@
 ---
-description: "Learn more about: Compiler Error C3867"
 title: "Compiler Error C3867"
+description: "Learn more about: Compiler Error C3867"
 ms.date: "11/04/2016"
 f1_keywords: ["C3867"]
 helpviewer_keywords: ["C3867"]
-ms.assetid: bc5de03f-e01a-4407-88c3-2c63f0016a1e
 ---
 # Compiler Error C3867
 
@@ -42,7 +41,7 @@ The following sample generates C3867 and shows how to fix it.
 
 ```cpp
 // C3867_2.cpp
-#include<stdio.h>
+#include <stdio.h>
 
 struct S {
    char *func() {

docs/standard-library/bad-alloc-class.md

@@ -1,10 +1,9 @@
 ---
-description: "Learn more about: bad_alloc Class"
 title: "bad_alloc Class"
+description: "Learn more about: bad_alloc Class"
 ms.date: "11/04/2016"
 f1_keywords: ["new/std::bad_alloc"]
 helpviewer_keywords: ["bad_alloc class"]
-ms.assetid: 6429a8e6-5a49-4907-8d56-f4a4ec8131d0
 ---
 # bad_alloc Class
 
@@ -31,8 +30,8 @@ The value returned by `what` is an implementation-defined C string. None of the
 ```cpp
 // bad_alloc.cpp
 // compile with: /EHsc
-#include<new>
-#include<iostream>
+#include <new>
+#include <iostream>
 using namespace std;
 
 int main() {

docs/standard-library/hash-map-class.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: hash_map Class"
 title: "hash_map Class"
+description: "Learn more about: hash_map Class"
 ms.date: "11/04/2016"
 f1_keywords: ["hash_map/stdext::hash_map", "hash_map/stdext::hash_map::allocator_type", "hash_map/stdext::hash_map::const_iterator", "hash_map/stdext::hash_map::const_pointer", "hash_map/stdext::hash_map::const_reference", "hash_map/stdext::hash_map::const_reverse_iterator", "hash_map/stdext::hash_map::difference_type", "hash_map/stdext::hash_map::iterator", "hash_map/stdext::hash_map::key_compare", "hash_map/stdext::hash_map::key_type", "hash_map/stdext::hash_map::mapped_type", "hash_map/stdext::hash_map::pointer", "hash_map/stdext::hash_map::reference", "hash_map/stdext::hash_map::reverse_iterator", "hash_map/stdext::hash_map::size_type", "hash_map/stdext::hash_map::value_type", "hash_map/stdext::hash_map::at", "hash_map/stdext::hash_map::begin", "hash_map/stdext::hash_map::cbegin", "hash_map/stdext::hash_map::cend", "hash_map/stdext::hash_map::clear", "hash_map/stdext::hash_map::count", "hash_map/stdext::hash_map::crbegin", "hash_map/stdext::hash_map::crend", "hash_map/stdext::hash_map::emplace", "hash_map/stdext::hash_map::emplace_hint", "hash_map/stdext::hash_map::empty", "hash_map/stdext::hash_map::end", "hash_map/stdext::hash_map::equal_range", "hash_map/stdext::hash_map::erase", "hash_map/stdext::hash_map::find", "hash_map/stdext::hash_map::get_allocator", "hash_map/stdext::hash_map::insert", "hash_map/stdext::hash_map::key_comp", "hash_map/stdext::hash_map::lower_bound", "hash_map/stdext::hash_map::max_size", "hash_map/stdext::hash_map::rbegin", "hash_map/stdext::hash_map::rend", "hash_map/stdext::hash_map::size", "hash_map/stdext::hash_map::swap", "hash_map/stdext::hash_map::upper_bound", "hash_map/stdext::hash_map::value_comp"]
 helpviewer_keywords: ["stdext::hash_map", "stdext::hash_map::allocator_type", "stdext::hash_map::const_iterator", "stdext::hash_map::const_pointer", "stdext::hash_map::const_reference", "stdext::hash_map::const_reverse_iterator", "stdext::hash_map::difference_type", "stdext::hash_map::iterator", "stdext::hash_map::key_compare", "stdext::hash_map::key_type", "stdext::hash_map::mapped_type", "stdext::hash_map::pointer", "stdext::hash_map::reference", "stdext::hash_map::reverse_iterator", "stdext::hash_map::size_type", "stdext::hash_map::value_type", "stdext::hash_map::at", "stdext::hash_map::begin", "stdext::hash_map::cbegin", "stdext::hash_map::cend", "stdext::hash_map::clear", "stdext::hash_map::count", "stdext::hash_map::crbegin", "stdext::hash_map::crend", "stdext::hash_map::emplace", "stdext::hash_map::emplace_hint", "stdext::hash_map::empty", "stdext::hash_map::end", "stdext::hash_map::equal_range", "stdext::hash_map::erase", "stdext::hash_map::find", "stdext::hash_map::get_allocator", "stdext::hash_map::insert", "stdext::hash_map::key_comp", "stdext::hash_map::lower_bound", "stdext::hash_map::max_size", "stdext::hash_map::rbegin", "stdext::hash_map::rend", "stdext::hash_map::size", "stdext::hash_map::swap", "stdext::hash_map::upper_bound", "stdext::hash_map::value_comp"]
@@ -817,8 +817,8 @@ The [`hash_map::value_type`](#value_type) of an element is a pair, so that the v
 ```cpp
 // hash_map_emplace.cpp
 // compile with: /EHsc
-#include<hash_map>
-#include<iostream>
+#include <hash_map>
+#include <iostream>
 #include <string>
 
 int main()
@@ -878,8 +878,8 @@ Insertion can occur in amortized constant time, instead of logarithmic time, if
 ```cpp
 // hash_map_emplace_hint.cpp
 // compile with: /EHsc
-#include<hash_map>
-#include<iostream>
+#include <hash_map>
+#include <iostream>
 #include <string>
 
 int main()
@@ -1545,8 +1545,8 @@ The third member function inserts the sequence of element values into a `hash_ma
 ```cpp
 // hash_map_insert.cpp
 // compile with: /EHsc
-#include<hash_map>
-#include<iostream>
+#include <hash_map>
+#include <iostream>
 #include <string>
 
 int main()