Skip to content

Repo sync for protected CLA branch #4229

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 24 commits into from
Oct 18, 2022
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
24 commits
Select commit Hold shift + click to select a range
1fe9bdc
Bulk Fix CRT Acrolinx issues 2
colin-home Oct 16, 2022
841c179
Bulk Fix CRT Acrolinx issues 1
colin-home Oct 16, 2022
cf7c368
Bulk Fix CRT Acrolinx issues 3 of N
colin-home Oct 16, 2022
0959212
Bulk Fix CRT Acrolinx issues 4 of N
colin-home Oct 16, 2022
cd6335b
Bulk Fix CRT Acrolinx issues 5 of N
colin-home Oct 17, 2022
6d9a50b
Fix type that broke table
colin-home Oct 17, 2022
7f7f43c
Merge pull request #4586 from corob-msft/bulk-fix-crt-acrolinx
19BMG00 Oct 17, 2022
3414fcf
Merge pull request #4587 from corob-msft/bulk-fix-crt-acrolinx-3
v-dirichards Oct 17, 2022
8fbc5dc
Merge pull request #4585 from corob-msft/bulk-fix-acrolinx-2
19BMG00 Oct 17, 2022
45fc6e8
Merge pull request #4589 from corob-msft/bulk-fix-crt-acrolinx-5
19BMG00 Oct 17, 2022
0b0873b
Merge pull request #4588 from corob-msft/bulk-fix-crt-acrolinx-4
v-dirichards Oct 17, 2022
ed832df
Bulk fix CRT Acrolinx issues 6 of N
colin-home Oct 17, 2022
43638b5
Bulk Fix CRT behavior, compatibility 8 of N
colin-home Oct 18, 2022
d402856
Merge pull request #4594 from corob-msft/bulk-fix-crt-acrolinx-8
colin-home Oct 18, 2022
460debd
Merge pull request #4591 from corob-msft/bulk-fix-crt-acrolinx-6
tamarakhader Oct 18, 2022
27cea7e
Merge pull request #4592 from MicrosoftDocs/FromPublicMasterBranch
prmerger-automator[bot] Oct 18, 2022
2144c3a
Bulk Fix CRT Acrolinx issues 9 of N (#4595)
colin-home Oct 18, 2022
fea2fcb
Bulk Fix CRT Acrolinx issues, 7 of N (#4593)
colin-home Oct 18, 2022
f41c469
Bulk Fix CRT Acrolinx issues 10 of N (#4596)
colin-home Oct 18, 2022
64449b7
Bulk Fix CRT Acrolinx issues 11 of N
colin-home Oct 18, 2022
80ed614
Bulk Fix CRT Acrolinx issues 12 of N (#4598)
colin-home Oct 18, 2022
baab20c
Merge pull request #4597 from corob-msft/bulk-fix-crt-acrolinx-11
v-ccolin Oct 18, 2022
2365dc1
Merge pull request #4599 from MicrosoftDocs/main
huypub Oct 18, 2022
1fdb0b3
Merging changes synced from https://github.com/MicrosoftDocs/cpp-docs…
opbld17 Oct 18, 2022
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
4 changes: 2 additions & 2 deletions docs/c-runtime-library/a-sample-generic-text-program.md
Original file line number Diff line number Diff line change
Expand Up @@ -87,7 +87,7 @@ int __cdecl main(int argc, char **argv, char **envp)
}
```

If `_UNICODE` has been defined, GENTEXT.C maps to the following Unicode version of the program. For more information about using `wmain` in Unicode programs as a replacement for `main`, see [Using wmain](../c-language/using-wmain.md) in *C Language Reference*.
If `_UNICODE` has been defined, GENTEXT.C maps to the following Unicode version of the program. For more information about using `wmain` in Unicode programs as a replacement for `main`, see [Using `wmain`](../c-language/using-wmain.md) in *C Language Reference*.

```C
// crt_unicgtxt.c
Expand Down Expand Up @@ -125,7 +125,7 @@ int __cdecl wmain(int argc, wchar_t **argv, wchar_t **envp)
}
```

If neither `_MBCS` nor `_UNICODE` has been defined, GENTEXT.C maps to single-byte ASCII code, as follows:
If `_MBCS` or `_UNICODE` hasn't been defined, GENTEXT.C maps to single-byte ASCII code, as follows:

```C
// crt_sbcsgtxt.c
Expand Down
2 changes: 1 addition & 1 deletion docs/c-runtime-library/abnormal-termination.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,7 +27,7 @@ int _abnormal_termination(

## Remarks

This is an internal function used to manage unwinding exceptions, and is not intended to be called from user code.
`_abnormal_termination` is an internal function used to manage unwinding exceptions, and isn't intended to be called from user code.

## Requirements

Expand Down
2 changes: 1 addition & 1 deletion docs/c-runtime-library/acmdln-tcmdln-wcmdln.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,7 +28,7 @@ wchar_t * _wcmdln;

## Remarks

These CRT internal variables store the complete command line. They are exposed in the exported symbols for the CRT, but are not intended for use in your code. `_acmdln` stores the data as a character string. `_wcmdln` stores the data as a wide character string. `_tcmdln` can be defined as either `_acmdln` or `_wcmdln`, depending on which is appropriate.
These CRT internal variables store the complete command line. They're exposed in the exported symbols for the CRT, but aren't intended for use in your code. `_acmdln` stores the data as a character string. `_wcmdln` stores the data as a wide character string. `_tcmdln` can be defined as either `_acmdln` or `_wcmdln`, depending on which is appropriate.

## See also

Expand Down
2 changes: 1 addition & 1 deletion docs/c-runtime-library/ansi-c-compliance.md
Original file line number Diff line number Diff line change
Expand Up @@ -13,7 +13,7 @@ The naming convention for all Microsoft-specific identifiers in the run-time sys

The names of Microsoft-specific functions and global variables begin with a single underscore. These names can be overridden only locally, within the scope of your code. For example, when you include Microsoft run-time header files, you can still locally override the Microsoft-specific function named `_open` by declaring a local variable of the same name. However, you can't use this name for your own global function or global variable.

The names of Microsoft-specific macros and manifest constants begin with two underscores, or with a single leading underscore immediately followed by an uppercase letter. The scope of these identifiers is absolute. For example, you can't use the Microsoft-specific identifier **_UPPER** for this reason.
The names of Microsoft-specific macros and manifest constants begin with two underscores, or with a single leading underscore immediately followed by an uppercase letter. The scope of such identifiers is absolute. For example, you can't use the Microsoft-specific identifier **_UPPER** for this reason.

## See also

Expand Down
4 changes: 2 additions & 2 deletions docs/c-runtime-library/argc-argv-wargv.md
Original file line number Diff line number Diff line change
Expand Up @@ -46,5 +46,5 @@ For portable code, we recommend you use the arguments passed to `main` to get th
## See also

[Global variables](../c-runtime-library/global-variables.md)\
[main function and command-line arguments (C++)](../cpp/main-function-command-line-args.md)\
[Using wmain Instead of main](../cpp/main-function-command-line-args.md)
[`main` function and command-line arguments (C++)](../cpp/main-function-command-line-args.md)\
[Using `wmain` instead of `main`](../cpp/main-function-command-line-args.md)
2 changes: 1 addition & 1 deletion docs/c-runtime-library/backward-compatibility.md
Original file line number Diff line number Diff line change
Expand Up @@ -10,7 +10,7 @@ ms.assetid: cc3175cf-97fd-492f-b329-5791aea63090

For compatibility between product versions, the library OLDNAMES.LIB maps old names to new names. For instance, `open` maps to `_open`. You must explicitly link with OLDNAMES.LIB only when you compile with the following combinations of command-line options:

- `/Zl` (omit default library name from object file) and `/Ze` (the default use Microsoft extensions)
- `/Zl` (omit default library name from object file) and `/Ze` (the default: use Microsoft extensions)

- `/link` (linker-control), `/NOD` (no default-library search), and `/Ze`

Expand Down
6 changes: 3 additions & 3 deletions docs/c-runtime-library/byte-and-wide-streams.md
Original file line number Diff line number Diff line change
Expand Up @@ -11,11 +11,11 @@ ms.assetid: 61ef0587-4cbc-4eb8-aae5-4c298dbbc6f9

A byte stream treats a file as a sequence of bytes. Within the program, the stream is the identical sequence of bytes.

By contrast, a wide stream treats a file as a sequence of generalized multibyte characters, which can have a broad range of encoding rules. (Text and binary files are still read and written as previously described.) Within the program, the stream looks like the corresponding sequence of wide characters. Conversions between the two representations occur within the Standard C Library. The conversion rules can, in principle, be altered by a call to [setlocale](../c-runtime-library/reference/setlocale-wsetlocale.md) that alters the category `LC_CTYPE`. Each wide stream determines its conversion rules at the time it becomes wide oriented, and retains these rules even if the category `LC_CTYPE` subsequently changes.
By contrast, a wide stream treats a file as a sequence of generalized multibyte characters, which can have a broad range of encoding rules. (Text and binary files are still read and written as previously described.) Within the program, the stream looks like the corresponding sequence of wide characters. Conversions between the two representations occur within the Standard C Library. The conversion rules can, in principle, be altered by a call to [`setlocale`](../c-runtime-library/reference/setlocale-wsetlocale.md) that alters the category `LC_CTYPE`. Each wide stream determines its conversion rules at the time it becomes wide oriented, and retains these rules even if the category `LC_CTYPE` later changes.

Positioning within a wide stream suffers the same limitations as for text steams. Moreover, the file-position indicator may well have to deal with a state-dependent encoding. Typically, it includes both a byte offset within the stream and an object of type `mbstate_t`. Thus, the only reliable way to obtain a file position within a wide stream is by calling [fgetpos](../c-runtime-library/reference/fgetpos.md), and the only reliable way to restore a position obtained this way is by calling [fsetpos](../c-runtime-library/reference/fsetpos.md).
Positioning within a wide stream suffers the same limitations as for text steams. Moreover, the file-position indicator may well have to deal with a state-dependent encoding. Typically, it includes both a byte offset within the stream and an object of type `mbstate_t`. Thus, the only reliable way to obtain a file position within a wide stream is by calling [`fgetpos`](../c-runtime-library/reference/fgetpos.md), and the only reliable way to restore a position obtained this way is by calling [`fsetpos`](../c-runtime-library/reference/fsetpos.md).

## See also

[Files and Streams](../c-runtime-library/files-and-streams.md)<br/>
[setlocale, _wsetlocale](../c-runtime-library/reference/setlocale-wsetlocale.md)
[`setlocale`, `_wsetlocale`](../c-runtime-library/reference/setlocale-wsetlocale.md)
2 changes: 1 addition & 1 deletion docs/c-runtime-library/byte-classification.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,7 +22,7 @@ The predefined constants in the following table are defined in `<ctype.h>`.
| [`isleadbyte`, `_isleadbyte_l`](../c-runtime-library/reference/isleadbyte-isleadbyte-l.md) | Lead byte; test result depends on `LC_CTYPE` category setting of current locale |
| [`_ismbbalnum`, `_ismbbalnum_l`](../c-runtime-library/reference/ismbbalnum-ismbbalnum-l.md) | `isalnum || _ismbbkalnum` |
| [`_ismbbalpha`, `_ismbbalpha_l`](../c-runtime-library/reference/ismbbalpha-ismbbalpha-l.md) | `isalpha || _ismbbkalpha` |
| [`_ismbbgraph`, `_ismbbgraph_l`](../c-runtime-library/reference/ismbbgraph-ismbbgraph-l.md) | Same as `_ismbbprint`, but `_ismbbgraph` does not include the space character (0x20) |
| [`_ismbbgraph`, `_ismbbgraph_l`](../c-runtime-library/reference/ismbbgraph-ismbbgraph-l.md) | Same as `_ismbbprint`, but `_ismbbgraph` doesn't include the space character (0x20) |
| [`_ismbbkalnum`, `_ismbbkalnum_l`](../c-runtime-library/reference/ismbbkalnum-ismbbkalnum-l.md) | Non-ASCII text symbol other than punctuation. For example, in code page 932 only, `_ismbbkalnum` tests for katakana alphanumeric |
| [`_ismbbkana`, `_ismbbkana_l`](../c-runtime-library/reference/ismbbkana-ismbbkana-l.md) | Katakana (0xA1 - 0xDF), code page 932 only |
| [`_ismbbkprint`, `_ismbbkprint_l`](../c-runtime-library/reference/ismbbkprint-ismbbkprint-l.md) | Non-ASCII text or non-ASCII punctuation symbol. For example, in code page 932 only, `_ismbbkprint` tests for katakana alphanumeric or katakana punctuation (range: 0xA1 - 0xDF). |
Expand Down
4 changes: 2 additions & 2 deletions docs/c-runtime-library/c-run-time-library-reference.md
Original file line number Diff line number Diff line change
Expand Up @@ -7,9 +7,9 @@ helpviewer_keywords: ["CRT", "runtime libraries", "CRT, reference"]
---
# Microsoft C runtime library (CRT) reference

The Microsoft runtime library provides routines for programming the Microsoft Windows operating system. These routines automate many common programming tasks that are not provided by the C and C++ languages.
The Microsoft runtime library provides routines for programming the Microsoft Windows operating system. These routines automate many common programming tasks that aren't provided by the C and C++ languages.

Sample programs are included in the individual reference topics for most routines in the library.
Sample programs are included in the individual reference articles for most routines in the library.

## In This Section

Expand Down
6 changes: 3 additions & 3 deletions docs/c-runtime-library/cgets-cgetws.md
Original file line number Diff line number Diff line change
Expand Up @@ -50,13 +50,13 @@ Storage location for data.

## Remarks

These functions read a string of characters from the console and store the string and its length in the location pointed to by `buffer`. The `buffer` parameter must be a pointer to a character array. The first element of the array, `buffer[0]`, must contain the maximum length (in characters) of the string to be read. The array must contain enough elements to hold the string, a terminating null character ('\0'), and 2 additional bytes. The function reads characters until a carriage return-line feed (CR-LF) combination or the specified number of characters is read. The string is stored starting at `buffer[2]`. If the function reads a CR-LF, it stores the null character ('\0'). The function then stores the actual length of the string in the second array element, `buffer[1]`.
These functions read a string of characters from the console and store the string and its length in the location pointed to by `buffer`. The `buffer` parameter must be a pointer to a character array. The first element of the array, `buffer[0]`, must contain the maximum length (in characters) of the string to be read. The array must contain enough elements to hold the string, a terminating null character ('\0'), and 2 extra bytes. The function reads characters until a carriage return-line feed (CR-LF) combination or the specified number of characters is read. The string is stored starting at `buffer[2]`. If the function reads a CR-LF, it stores the null character ('\0'). The function then stores the actual length of the string in the second array element, `buffer[1]`.

Because all editing keys are active when `_cgets` or `_cgetws` is called while in a console window, pressing the F3 key repeats the last entered entry.

In C++, these functions have template overloads that invoke the newer, secure counterparts of these functions. For more information, see [Secure Template Overloads](../c-runtime-library/secure-template-overloads.md).

By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](global-state.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).

### Generic-Text Routine Mappings

Expand Down Expand Up @@ -120,4 +120,4 @@ Text = A line of input.
## See also

[Console and Port I/O](../c-runtime-library/console-and-port-i-o.md)<br/>
[_getch, _getwch](../c-runtime-library/reference/getch-getwch.md)
[`_getch`, `_getwch`](../c-runtime-library/reference/getch-getwch.md)
4 changes: 2 additions & 2 deletions docs/c-runtime-library/character-classification.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ ms.assetid: 3b6c8f0b-9701-407a-b384-9086698773f5
---
# Character Classification

Each of these routines tests a specified single-byte character, wide character, or multibyte character for satisfaction of a condition. (By definition, the ASCII character set between 0 and 127 are a subset of all multibyte-character sets. For example, Japanese katakana includes ASCII as well as non-ASCII characters.)
Each of these routines tests a specified single-byte character, wide character, or multibyte character for satisfaction of a condition. (By definition, the ASCII character set between 0 and 127 are a subset of all multibyte-character sets. For example, Japanese katakana includes both ASCII and non-ASCII characters.)

The test conditions are affected by the setting of the **LC_CTYPE** category setting of the locale; see [setlocale](../c-runtime-library/reference/setlocale-wsetlocale.md) for more information. The versions of these functions without the **_l** suffix use the current locale for this locale-dependent behavior; the versions with the **_l** suffix are identical except that they use the locale parameter passed in instead.
The test conditions are affected by the setting of the **LC_CTYPE** category setting of the locale. For more information, see [`setlocale`](../c-runtime-library/reference/setlocale-wsetlocale.md). The versions of these functions without the **_l** suffix use the current locale for this locale-dependent behavior; the versions with the **_l** suffix are identical except that they use the locale parameter passed in instead.

Generally these routines execute faster than tests you might write and should be favored over. For example, the following code executes slower than a call to `isalpha(c)`:

Expand Down
4 changes: 2 additions & 2 deletions docs/c-runtime-library/ciatan.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This version of the `atan` function has a specialized calling convention that th

The resulting value is pushed onto the top of the stack.

By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](global-state.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).

## Requirements

Expand All @@ -35,4 +35,4 @@ By default, this function's global state is scoped to the application. To change
## See also

[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
[atan, atanf, atanl, atan2, atan2f, atan2l](../c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md)
[`atan`, `atanf`, `atanl`, `atan2`, `atan2f`, `atan2l`](../c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md)
4 changes: 2 additions & 2 deletions docs/c-runtime-library/ciatan2.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This version of the `atan2` function has a specialized calling convention that t

The resulting value is pushed onto the top of the stack.

By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](global-state.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).

## Requirements

Expand All @@ -35,4 +35,4 @@ By default, this function's global state is scoped to the application. To change
## See also

[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
[atan, atanf, atanl, atan2, atan2f, atan2l](../c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md)
[`atan`, `atanf`, `atanl`, `atan2`, `atan2f`, `atan2l`](../c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md)
6 changes: 3 additions & 3 deletions docs/c-runtime-library/cicos.md
Original file line number Diff line number Diff line change
Expand Up @@ -22,11 +22,11 @@ void __cdecl _CIcos();

## Remarks

This version of the [cos](../c-runtime-library/reference/cos-cosf-cosl.md) function has a specialized calling convention that the compiler understands. It speeds up the execution because it prevents copies from being generated and helps with register allocation.
This version of the [`cos`](../c-runtime-library/reference/cos-cosf-cosl.md) function has a specialized calling convention that the compiler understands. It speeds up the execution because it prevents copies from being generated and helps with register allocation.

The resulting value is pushed onto the top of the floating-point stack.

By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](global-state.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).

## Requirements

Expand All @@ -35,4 +35,4 @@ By default, this function's global state is scoped to the application. To change
## See also

[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
[cos, cosf, cosl](../c-runtime-library/reference/cos-cosf-cosl.md)<br/>
[`cos`, `cosf`, `cosl`](../c-runtime-library/reference/cos-cosf-cosl.md)
4 changes: 2 additions & 2 deletions docs/c-runtime-library/ciexp.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This version of the `exp` function has a specialized calling convention that the

The resulting value is pushed onto the top of the stack.

By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](global-state.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).

## Requirements

Expand All @@ -35,4 +35,4 @@ By default, this function's global state is scoped to the application. To change
## See also

[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
[exp, expf, expl](../c-runtime-library/reference/exp-expf.md)
[`exp`, `expf`, `expl`](../c-runtime-library/reference/exp-expf.md)
4 changes: 2 additions & 2 deletions docs/c-runtime-library/cifmod.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This version of the `fmod` function has a specialized calling convention that th

The resulting value is pushed onto the top of the stack.

By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](global-state.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).

## Requirements

Expand All @@ -35,4 +35,4 @@ By default, this function's global state is scoped to the application. To change
## See also

[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
[fmod, fmodf](../c-runtime-library/reference/fmod-fmodf.md)
[`fmod`, `fmodf`](../c-runtime-library/reference/fmod-fmodf.md)
4 changes: 2 additions & 2 deletions docs/c-runtime-library/cilog.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,7 @@ This version of the `log` function has a specialized calling convention that the

The resulting value is pushed onto the top of the stack.

By default, this function's global state is scoped to the application. To change this, see [Global state in the CRT](global-state.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).

## Requirements

Expand All @@ -35,4 +35,4 @@ By default, this function's global state is scoped to the application. To change
## See also

[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
[log, logf, log10, log10f](../c-runtime-library/reference/log-logf-log10-log10f.md)
[`log`, `logf`, `log10`, `log10f`](../c-runtime-library/reference/log-logf-log10-log10f.md)
Loading