Merge pull request #5815 from MicrosoftDocs/main

3/04/2025 AM Publish

Author: Albertyang0

docs/c-language/extern-storage-class-specifier.md

@@ -1,9 +1,8 @@
 ---
-description: "Learn more about: extern Storage-Class Specifier"
 title: "extern Storage-Class Specifier"
+description: "Learn more about: extern Storage-Class Specifier"
 ms.date: "07/10/2018"
 helpviewer_keywords: ["extern keyword [C]", "storage class specifiers, extern", "extern keyword [C], storage class specifier", "external linkage, storage-class specifiers", "external linkage, extern modifier"]
-ms.assetid: 6e16d927-291f-49e4-986c-9d91a482a441
 ---
 # extern Storage-Class Specifier
 
@@ -14,12 +13,11 @@ A variable declared with the **`extern`** storage-class specifier is a reference
 This example illustrates internal- and external-level declarations:
 
 ```c
-
 // Source1.c
 
 int i = 1;
 
-// Source2. c
+// Source2.c
 
 #include <stdio.h>
 

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

@@ -1,13 +1,12 @@
 ---
-description: "Learn more about: and"
 title: "and"
+description: "Learn more about: and"
 ms.date: "11/04/2016"
 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: ["ISO646/and", "and", "std.and", "std::and"]
 helpviewer_keywords: ["and macro"]
-ms.assetid: 2644ab57-8e1b-48f0-9021-cafe3e26bdc4
 ---
 # `and`
 
@@ -16,7 +15,6 @@ An alternative to the && operator.
 ## Syntax
 
 ```C
-
 #define and &&
 ```
 

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

@@ -1,13 +1,12 @@
 ---
-description: "Learn more about: bitand"
 title: "bitand"
+description: "Learn more about: bitand"
 ms.date: "11/04/2016"
 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: ["std::bitand", "std.bitand", "ISO646/bitand", "bitand"]
 helpviewer_keywords: ["bitand function"]
-ms.assetid: 279cf9b5-fac1-49de-b329-f1a31b3481fe
 ---
 # `bitand`
 
@@ -16,7 +15,6 @@ An alternative to the & operator.
 ## Syntax
 
 ```C
-
 #define bitand &
 ```
 

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

@@ -1,13 +1,12 @@
 ---
-description: "Learn more about: bitor"
 title: "bitor"
+description: "Learn more about: bitor"
 ms.date: "11/04/2016"
 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: ["ISO646/bitor", "bitor", "std.bitor", "std::bitor"]
 helpviewer_keywords: ["bitor function"]
-ms.assetid: 3c0a3711-9c74-41f2-b400-2f7797da30d1
 ---
 # `bitor`
 
@@ -16,7 +15,6 @@ An alternative to the `|` operator.
 ## Syntax
 
 ```C
-
 #define bitor |
 ```
 

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

@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: _CrtCheckMemory"
 title: "_CrtCheckMemory"
+description: "Learn more about: _CrtCheckMemory"
 ms.date: "11/04/2016"
 api_name: ["_CrtCheckMemory"]
 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: ["CrtCheckMemory", "_CrtCheckMemory"]
 helpviewer_keywords: ["_CrtCheckMemory function", "CrtCheckMemory function"]
-ms.assetid: 457cc72e-60fd-4177-ab5c-6ae26a420765
 ---
 # `_CrtCheckMemory`
 
@@ -17,7 +16,6 @@ Confirms the integrity of the memory blocks allocated in the debug heap (debug v
 ## Syntax
 
 ```C
-
 int _CrtCheckMemory( void );
 ```
 

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

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: _CrtDumpMemoryLeaks"
 title: "_CrtDumpMemoryLeaks"
+description: "Learn more about: _CrtDumpMemoryLeaks"
 ms.date: "11/04/2016"
 api_name: ["_CrtDumpMemoryLeaks"]
 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"]
@@ -16,7 +16,6 @@ Dumps all the memory blocks in the debug heap when a memory leak has occurred (d
 ## Syntax
 
 ```C
-
 int _CrtDumpMemoryLeaks( void );
 ```
 

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

@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: _kbhit"
 title: "_kbhit"
+description: "Learn more about: _kbhit"
 ms.date: "4/2/2020"
 api_name: ["_kbhit", "_o__kbhit"]
 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-stdio-l1-1-0.dll"]
 api_type: ["DLLExport"]
 topic_type: ["apiref"]
 f1_keywords: ["_kbhit", "conio/_kbhit"]
 helpviewer_keywords: ["keyboard input", "user input, checking for keyboard", "kbhit function", "console", "console, checking", "keyboards, keyboard input", "_kbhit function", "keyboards, checking input"]
-ms.assetid: e82a1cc9-bbec-4150-b678-a7e433220fe4
 ---
 # `_kbhit`
 
@@ -20,7 +19,6 @@ Checks the console for keyboard input.
 ## Syntax
 
 ```C
-
 int _kbhit( void );
 ```
 

docs/c-runtime-library/reference/mkdir-wmkdir.md

@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: _mkdir, _wmkdir"
 title: "_mkdir, _wmkdir"
+description: "Learn more about: _mkdir, _wmkdir"
 ms.date: "4/2/2020"
 api_name: ["_wmkdir", "_mkdir", "_o__mkdir", "_o__wmkdir"]
 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"]
 api_type: ["DLLExport"]
 topic_type: ["apiref"]
 f1_keywords: ["_mkdir", "tmkdir", "_tmkdir", "wmkdir", "_wmkdir"]
 helpviewer_keywords: ["_wmkdir function", "folders [C++], creating", "wmkdir function", "directories [C++], creating", "mkdir function", "tmkdir function", "_mkdir function", "_tmkdir function"]
-ms.assetid: 7f22d01d-63a5-4712-a6e7-d34878b2d840
 ---
 # `_mkdir`, `_wmkdir`
 
@@ -17,7 +16,6 @@ Creates a new directory.
 ## Syntax
 
 ```C
-
 int _mkdir(
    const char *dirname
 );

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

@@ -1,13 +1,12 @@
 ---
-description: "Learn more about: not"
 title: "not"
+description: "Learn more about: not"
 ms.date: "11/04/2016"
 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: ["std::not", "std.not", "ISO646/not", "not"]
 helpviewer_keywords: ["not function"]
-ms.assetid: d2ddbd5c-33c0-4aff-8961-feac155b4ba1
 ---
 # `not`
 
@@ -16,7 +15,6 @@ An alternative to the **`!`** operator.
 ## Syntax
 
 ```C
-
 #define not !
 ```
 

docs/c-runtime-library/reference/or-eq.md

@@ -1,13 +1,12 @@
 ---
-description: "Learn more about: or_eq"
 title: "or_eq"
+description: "Learn more about: or_eq"
 ms.date: "11/04/2016"
 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: ["std::or_eq", "ISO646/or_eq", "or_eq", "std.or_eq"]
 helpviewer_keywords: ["or_eq function"]
-ms.assetid: 1eb92464-ed58-40d8-a30e-f0a6aa2f4318
 ---
 # `or_eq`
 
@@ -16,7 +15,6 @@ An alternative to the `|=` operator.
 ## Syntax
 
 ```C
-
 #define or_eq |=
 ```
 

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

@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: _rmtmp"
 title: "_rmtmp"
+description: "Learn more about: _rmtmp"
 ms.date: "4/2/2020"
 api_name: ["_rmtmp", "_o__rmtmp"]
 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-stdio-l1-1-0.dll"]
 api_type: ["DLLExport"]
 topic_type: ["apiref"]
 f1_keywords: ["_rmtmp"]
 helpviewer_keywords: ["removing temporary files", "_rmtmp function", "files [C++], temporary", "rmtmp function", "files [C++], removing", "temporary files [C++], removing"]
-ms.assetid: 7419501e-2587-4f2a-b469-0dca07f84736
 ---
 # `_rmtmp`
 
@@ -17,7 +16,6 @@ Removes temporary files.
 ## Syntax
 
 ```C
-
 int _rmtmp( void );
 ```
 

docs/c-runtime-library/reference/rotl-rotl64-rotr-rotr64.md

@@ -8,7 +8,6 @@ api_type: ["DLLExport"]
 topic_type: ["apiref"]
 f1_keywords: ["_rotr64", "rotl64", "_rotl64", "rotr64", "rotr", "_rotr", "_rotl", "rotl"]
 helpviewer_keywords: ["rotl64 function", "_rotl function", "rotr function", "rotr64 function", "_rotr function", "rotl function", "_rotl64 function", "rotating bits", "_rotr64 function", "bits, rotating"]
-ms.assetid: cfce439b-366f-4584-8ab1-d527b13fcfc6
 ---
 # `_rotl`, `_rotl64`, `_rotr`, `_rotr64`
 
@@ -17,7 +16,6 @@ Rotates bits to the left (**`_rotl`**) or right (**`_rotr`**).
 ## Syntax
 
 ```C
-
 unsigned int _rotl(
    unsigned int value,
    int shift

docs/c-runtime-library/reference/rtc-numerrors.md

@@ -1,14 +1,13 @@
 ---
-description: "Learn more about: _RTC_NumErrors"
 title: "_RTC_NumErrors"
+description: "Learn more about: _RTC_NumErrors"
 ms.date: "11/04/2016"
 api_name: ["_RTC_NumErrors"]
 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: ["_RTC_NumErrors", "RTC_NumErrors"]
 helpviewer_keywords: ["run-time errors", "_RTC_NumErrors function", "RTC_NumErrors function"]
-ms.assetid: 7e82adae-38e2-4f8b-bc0b-37bda8109fd1
 ---
 # `_RTC_NumErrors`
 
@@ -17,7 +16,6 @@ Returns the total number of errors that can be detected by run-time error checks
 ## Syntax
 
 ```C
-
 int _RTC_NumErrors( void );
 ```
 

docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md

@@ -59,6 +59,9 @@ These functions differ from **`_vscprintf`** and **`_vscwprintf`** only in that
 
 The versions of these functions with the **`_l`** suffix are identical except that they use the locale parameter passed in instead of the current thread locale.
 
+Return Value is the size of the formatted data. If the function takes a `char` buffer, the size is in bytes. If the function takes a `wchar_t` buffer, the size specifies the number of 16-bit words.
+Characters refer to `char` characters for functions that take a `char` buffer, and to `wchar_t` characters for functions that take a `wchar_t` buffer.
+
 If *`format`* is a null pointer, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`.
 
 > [!IMPORTANT]

docs/c-runtime-library/reference/vscprintf-vscprintf-l-vscwprintf-vscwprintf-l.md

@@ -59,6 +59,9 @@ If *`format`* is a null pointer, the invalid parameter handler is invoked, as de
 
 ## Remarks
 
+Return Value is the size of the formatted data. If the function takes a `char` buffer, the size is in bytes. If the function takes a `wchar_t` buffer, the size specifies the number of 16-bit words.
+Characters refer to `char` characters for functions that take a `char` buffer, and to `wchar_t` characters for functions that take a `wchar_t` buffer.
+
 Each *`argument`* (if any) is converted according to the corresponding format specification in *`format`*. The format consists of ordinary characters and has the same form and function as the *`format`* argument for [`printf`](printf-printf-l-wprintf-wprintf-l.md).
 
 > [!IMPORTANT]

docs/code-quality/annotating-structs-and-classes.md

@@ -1,6 +1,6 @@
 ---
-description: "Learn more about: Annotating Structs and Classes"
 title: Annotating Structs and Classes
+description: "Learn more about: Annotating Structs and Classes"
 ms.date: 06/28/2019
 ms.topic: "conceptual"
 f1_keywords:
@@ -19,7 +19,6 @@ f1_keywords:
   - "_Field_size_full_"
   - "_Field_size_full_opt_"
   - "_Field_z_"
-ms.assetid: b8278a4a-c86e-4845-aa2a-70da21a1dd52
 ---
 # Annotating Structs and Classes
 
@@ -52,13 +51,11 @@ You can annotate struct and class members by using annotations that act like inv
      Applies to struct or class declaration.  Indicates that a valid object of that type may be larger than the declared type, with the number of bytes being specified by `size`.  For example:
 
     ```cpp
-
     typedef _Struct_size_bytes_(nSize)
     struct MyStruct {
         size_t nSize;
         ...
     };
-
     ```
 
      The buffer size in bytes of a parameter `pM` of type `MyStruct *` is then taken to be:

docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_1.cpp

@@ -1,4 +1,3 @@
-
     // Use make_shared function when possible.
     auto sp1 = make_shared<Song>(L"The Beatles", L"Im Happy Just to Dance With You");
 

docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_6.cpp

@@ -1,4 +1,3 @@
-
     // Initialize two separate raw pointers.
     // Note that they contain the same values.
     auto song1 = new Song(L"Village People", L"YMCA");

docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp

@@ -1,4 +1,3 @@
-
 class MyClass
 {
 private:

docs/cpp/codesnippet/CPP/smart-pointers-modern-cpp_2.cpp

@@ -1,4 +1,3 @@
-
 class LargeObject
 {
 public: