Merge pull request #4636 from corob-msft/bulk-fix-crt-acrolinx-31

Bulk fix CRT Acrolinx issues, 31 of 31

Author: prmerger-automator[bot]

docs/c-runtime-library/reference/wcsrtombs-s.md

@@ -73,17 +73,17 @@ The **`wcsrtombs_s`** function converts a string of wide characters pointed to b
 
 - A null wide character is encountered
 
-- A wide character that cannot be converted is encountered
+- A wide character that can't be converted is encountered
 
 - The number of bytes stored in the *`mbstr`* buffer equals *`count`*.
 
-The destination string is always null-terminated (even in the case of an error).
+The destination string is always null-terminated (even if there's an error).
 
 If *`count`* is the special value [`_TRUNCATE`](../truncate.md), then **`wcsrtombs_s`** converts as much of the string as will fit into the destination buffer, while still leaving room for a null terminator.
 
-If **`wcsrtombs_s`** successfully converts the source string, it puts the size in bytes of the converted string, including the null terminator, into `*pReturnValue` (provided *`pReturnValue`* is not `NULL`). This occurs even if the *`mbstr`* argument is `NULL` and provides a way to determine the required buffer size. Note that if *`mbstr`* is `NULL`, *`count`* is ignored.
+If **`wcsrtombs_s`** successfully converts the source string, it puts the size in bytes of the converted string, including the null terminator, into `*pReturnValue` (provided *`pReturnValue`* isn't `NULL`). The size is calculated even if the *`mbstr`* argument is `NULL`; it provides a way to determine the required buffer size. If *`mbstr`* is `NULL`, *`count`* is ignored.
 
-If **`wcsrtombs_s`** encounters a wide character it cannot convert to a multibyte character, it puts -1 in *\*`pReturnValue`*, sets the destination buffer to an empty string, sets `errno` to `EILSEQ`, and returns `EILSEQ`.
+If **`wcsrtombs_s`** encounters a wide character it can't convert to a multibyte character, it puts -1 in *\*`pReturnValue`*, sets the destination buffer to an empty string, sets `errno` to `EILSEQ`, and returns `EILSEQ`.
 
 If the sequences pointed to by *`wcstr`* and *`mbstr`* overlap, the behavior of **`wcsrtombs_s`** is undefined. **`wcsrtombs_s`** is affected by the LC_TYPE category of the current locale.
 

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

@@ -41,7 +41,7 @@ The resulting converted multibyte character string's address location.
 Indirectly points to the location of the wide character string to be converted.
 
 *`count`*\
-The number of character to be converted.
+The number of characters to be converted.
 
 *`mbstate`*\
 A pointer to an `mbstate_t` conversion state object.
@@ -58,15 +58,15 @@ Thus, the multibyte character string at *`mbstr`* is null-terminated only if **`
 
 The **`wcsrtombs`** function differs from [`wcstombs`, `_wcstombs_l`](wcstombs-wcstombs-l.md) by its restartability. The conversion state is stored in *`mbstate`* for subsequent calls to the same or other restartable functions. Results are undefined when mixing the use of restartable and nonrestartable functions.  For example, an application would use `wcsrlen` rather than `wcsnlen`, if a subsequent call to **`wcsrtombs`** were used instead of `wcstombs`.
 
-If the *`mbstr`* argument is `NULL`, **`wcsrtombs`** returns the required size in bytes of the destination string. If *`mbstate`* is null, the internal `mbstate_t` conversion state is used. If the character sequence *`wchar`* does not have a corresponding multibyte character representation, a -1 is returned and the `errno` is set to `EILSEQ`.
+If the *`mbstr`* argument is `NULL`, **`wcsrtombs`** returns the required size in bytes of the destination string. If *`mbstate`* is null, the internal `mbstate_t` conversion state is used. If the character sequence *`wchar`* doesn't have a corresponding multibyte character representation, a -1 is returned, and the `errno` is set to `EILSEQ`.
 
 In C++, this function has a template overload that invokes the newer, secure counterpart of this function. For more information, see [Secure template overloads](../secure-template-overloads.md).
 
 By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md).
 
 ## Exceptions
 
-The **`wcsrtombs`** function is multithread safe as long as no function in the current thread calls `setlocale` while this function is executing and the *`mbstate`* is not null.
+The **`wcsrtombs`** function is multithread safe as long as no function in the current thread calls `setlocale` while this function is executing and the *`mbstate`* isn't null.
 
 ## Example
 

docs/c-runtime-library/reference/wcstombs-s-wcstombs-s-l.md

@@ -89,17 +89,17 @@ The **`wcstombs_s`** function converts a string of wide characters pointed to by
 
 - A null wide character is encountered
 
-- A wide character that cannot be converted is encountered
+- A wide character that can't be converted is encountered
 
 - The number of bytes stored in the *`mbstr`* buffer equals *`count`*.
 
-The destination string is always null-terminated (even in the case of an error).
+The destination string is always null-terminated (even if there's an error).
 
 If *`count`* is the special value [`_TRUNCATE`](../truncate.md), then **`wcstombs_s`** converts as much of the string as will fit into the destination buffer, while still leaving room for a null terminator. If the string is truncated, the return value is `STRUNCATE`, and the conversion is considered successful.
 
-If **`wcstombs_s`** successfully converts the source string, it puts the size in bytes of the converted string, including the null terminator, into *`*pReturnValue`* (provided *`pReturnValue`* is not `NULL`). This occurs even if the *`mbstr`* argument is `NULL` and provides a way to determine the required buffer size. Note that if *`mbstr`* is `NULL`, *`count`* is ignored.
+If **`wcstombs_s`** successfully converts the source string, it puts the size in bytes of the converted string, including the null terminator, into *`*pReturnValue`* (provided *`pReturnValue`* isn't `NULL`). The size is calculated even if the *`mbstr`* argument is `NULL`; it provides a way to determine the required buffer size. If *`mbstr`* is `NULL`, *`count`* is ignored.
 
-If **`wcstombs_s`** encounters a wide character it cannot convert to a multibyte character, it puts 0 in *`*ReturnValue`*, sets the destination buffer to an empty string, sets `errno` to `EILSEQ`, and returns `EILSEQ`.
+If **`wcstombs_s`** encounters a wide character it can't convert to a multibyte character, it puts 0 in *`*ReturnValue`*, sets the destination buffer to an empty string, sets `errno` to `EILSEQ`, and returns `EILSEQ`.
 
 If the sequences pointed to by *`wcstr`* and *`mbstr`* overlap, the behavior of **`wcstombs_s`** is undefined.
 

docs/c-runtime-library/reference/wcstombs-wcstombs-l.md

@@ -62,7 +62,7 @@ If **`wcstombs`** successfully converts the multibyte string, it returns the num
 
 ## Remarks
 
-The **`wcstombs`** function converts the wide-character string pointed to by *`wcstr`* to the corresponding multibyte characters and stores the results in the *`mbstr`* array. The *`count`* parameter indicates the maximum number of bytes that can be stored in the multibyte output string (that is, the size of *`mbstr`*). In general, it isn't known how many bytes will be required when converting a wide-character string. Some wide characters will require only one byte in the output string; others require two. If there are two bytes in the multibyte output string for every wide character in the input string (including the wide character `NULL`), the result is guaranteed to fit.
+The **`wcstombs`** function converts the wide-character string pointed to by *`wcstr`* to the corresponding multibyte characters and stores the results in the *`mbstr`* array. The *`count`* parameter indicates the maximum number of bytes that can be stored in the multibyte output string (that is, the size of *`mbstr`*). In general, it isn't known how many bytes will be required when converting a wide-character string. Some wide characters will require only a single byte in the output string; others require 2 bytes. If there are 2 bytes in the multibyte output string for every wide character in the input string (including the wide character `NULL`), the result is guaranteed to fit.
 
 If **`wcstombs`** encounters the wide-character `NULL` character (L'\0') either before or when *`count`* occurs, it converts it to an 8-bit 0 and stops. Thus, the multibyte character string at *`mbstr`* is null-terminated only if **`wcstombs`** encounters a wide-character `NULL` character during conversion. If the sequences pointed to by *`wcstr`* and *`mbstr`* overlap, the behavior of **`wcstombs`** is undefined.
 

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

@@ -29,18 +29,18 @@ A string that specifies one of the valid transformations.
 
 ## Return value
 
-If the `LC_CTYPE` category of the current locale does not define a mapping whose name matches the property string *`property`*, the function returns zero. Otherwise, it returns a nonzero value suitable for use as the second argument to a subsequent call to [`towctrans`](towctrans.md).
+If the `LC_CTYPE` category of the current locale doesn't define a mapping whose name matches the property string *`property`*, the function returns zero. Otherwise, it returns a nonzero value suitable for use as the second argument to a subsequent call to [`towctrans`](towctrans.md).
 
 ## Remarks
 
 This function determines a mapping from one set of character codes to another.
 
-The following pairs of calls have the same behavior in all locales, but it is possible to define additional mappings even in the "C" locale:
+The following pairs of calls have the same behavior in all locales, but it's possible to define more mappings even in the "C" locale:
 
 |Function|Same As|
 |--------------|-------------|
-|tolower(c)|towctrans(c, wctrans("towlower"))|
-|towupper(c)|towctrans(c, wctrans("toupper"))|
+|`tolower(c)`|`towctrans(c, wctrans("towlower"))`|
+|`towupper(c)`|`towctrans(c, wctrans("toupper"))`|
 
 ## Requirements
 

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

@@ -32,7 +32,7 @@ If the `LC_CTYPE` category of the current locale doesn't define a classification
 
 ## Remarks
 
-The function determines a classification rule for wide-character codes. The following pairs of calls have the same behavior in all locales (but an implementation can define additional classification rules even in the "C" locale):
+The function determines a classification rule for wide-character codes. The following pairs of calls have the same behavior in all locales (but an implementation can define more classification rules even in the "C" locale):
 
 |Function|Same as|
 |--------------|-------------|

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

@@ -36,7 +36,7 @@ Number of bytes.
 
 ## Return value
 
-If successful, **`_write`** returns the number of bytes written. If the actual space remaining on the disk is less than the size of the buffer the function is trying to write to the disk, **`_write`** fails and doesn't flush any of the buffer's contents to the disk. A return value of -1 indicates an error. If invalid parameters are passed, this function invokes the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the function returns -1 and `errno` is set to one of three values: `EBADF`, which means the file descriptor is invalid or the file isn't opened for writing; `ENOSPC`, which means there isn't enough space left on the device for the operation; or `EINVAL`, which means that *`buffer`* was a null pointer or that an odd *`count`* of bytes was passed to be written to a file in Unicode mode.
+If successful, **`_write`** returns the number of bytes written. If the actual space remaining on the disk is less than the size of the buffer the function is trying to write to the disk, **`_write`** fails and doesn't flush any of the buffer's contents to the disk. A return value of -1 indicates an error. If invalid parameters are passed, this function invokes the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the function returns -1 and `errno` is set to one of three values: `EBADF`, which means the file descriptor is invalid or the file isn't opened for writing; `ENOSPC`, which means there isn't enough space left on the device for the operation; or `EINVAL`, which means that *`buffer`* was a null pointer, or that an odd *`count`* of bytes was passed in Unicode mode.
 
 For more information about these and other return codes, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md).
 
@@ -48,7 +48,7 @@ When the file is opened in Unicode translation mode—for example, if *`fd`* is
 
 The **`_write`** function writes *`count`* bytes from *`buffer`* into the file associated with *`fd`*. The write operation begins at the current position of the file pointer (if any) associated with the given file. If the file is open for appending, the operation begins at the current end of the file. After the write operation, the file pointer is increased by the number of bytes written.
 
-When writing to files opened in text mode, **`_write`** treats a CTRL+Z character as the logical end of file. When writing to a device, **`_write`** treats a CTRL+Z character in the buffer as an output terminator.
+When it writes to files opened in text mode, **`_write`** treats a CTRL+Z character as the logical end of file. When it writes to a device, **`_write`** treats a CTRL+Z character in the buffer as an output terminator.
 
 By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md).
 

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

@@ -11,18 +11,17 @@ ms.assetid: eca4b6b4-b77a-4d44-a09a-5a7e69fdb56c
 ---
 # `xor_eq`
 
-An alternative to the ^= operator.
+An alternative to the **`^=`** operator.
 
 ## Syntax
 
 ```C
-
 #define xor_eq ^=
 ```
 
 ## Remarks
 
-The macro yields the operator ^=.
+The macro yields the operator **`^=`**.
 
 ## Example
 

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

@@ -11,18 +11,17 @@ ms.assetid: 0fe9554b-d87b-4487-92ed-366c6dc21df2
 ---
 # `xor`
 
-An alternative to the ^ operator.
+An alternative to the **`^`** operator.
 
 ## Syntax
 
 ```C
-
 #define xor ^
 ```
 
 ## Remarks
 
-The macro yields the operator ^.
+The macro yields the operator **`^`**.
 
 ## Example