Skip to content

Commit 4e04334

Browse files
authored
Merge pull request #4229 from MicrosoftDocs/main638017111181142266sync_temp
Repo sync for protected CLA branch
2 parents cda0a71 + 1fdb0b3 commit 4e04334

File tree

671 files changed

+1867
-1834
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

671 files changed

+1867
-1834
lines changed

docs/c-runtime-library/a-sample-generic-text-program.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -87,7 +87,7 @@ int __cdecl main(int argc, char **argv, char **envp)
8787
}
8888
```
8989

90-
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*.
90+
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*.
9191

9292
```C
9393
// crt_unicgtxt.c
@@ -125,7 +125,7 @@ int __cdecl wmain(int argc, wchar_t **argv, wchar_t **envp)
125125
}
126126
```
127127
128-
If neither `_MBCS` nor `_UNICODE` has been defined, GENTEXT.C maps to single-byte ASCII code, as follows:
128+
If `_MBCS` or `_UNICODE` hasn't been defined, GENTEXT.C maps to single-byte ASCII code, as follows:
129129
130130
```C
131131
// crt_sbcsgtxt.c

docs/c-runtime-library/abnormal-termination.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -27,7 +27,7 @@ int _abnormal_termination(
2727
2828
## Remarks
2929
30-
This is an internal function used to manage unwinding exceptions, and is not intended to be called from user code.
30+
`_abnormal_termination` is an internal function used to manage unwinding exceptions, and isn't intended to be called from user code.
3131
3232
## Requirements
3333

docs/c-runtime-library/acmdln-tcmdln-wcmdln.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,7 @@ wchar_t * _wcmdln;
2828

2929
## Remarks
3030

31-
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.
31+
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.
3232

3333
## See also
3434

docs/c-runtime-library/ansi-c-compliance.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -13,7 +13,7 @@ The naming convention for all Microsoft-specific identifiers in the run-time sys
1313

1414
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.
1515

16-
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.
16+
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.
1717

1818
## See also
1919

docs/c-runtime-library/argc-argv-wargv.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -46,5 +46,5 @@ For portable code, we recommend you use the arguments passed to `main` to get th
4646
## See also
4747

4848
[Global variables](../c-runtime-library/global-variables.md)\
49-
[main function and command-line arguments (C++)](../cpp/main-function-command-line-args.md)\
50-
[Using wmain Instead of main](../cpp/main-function-command-line-args.md)
49+
[`main` function and command-line arguments (C++)](../cpp/main-function-command-line-args.md)\
50+
[Using `wmain` instead of `main`](../cpp/main-function-command-line-args.md)

docs/c-runtime-library/backward-compatibility.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ ms.assetid: cc3175cf-97fd-492f-b329-5791aea63090
1010

1111
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:
1212

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

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

docs/c-runtime-library/byte-and-wide-streams.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -11,11 +11,11 @@ ms.assetid: 61ef0587-4cbc-4eb8-aae5-4c298dbbc6f9
1111

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

14-
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.
14+
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.
1515

16-
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).
16+
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).
1717

1818
## See also
1919

2020
[Files and Streams](../c-runtime-library/files-and-streams.md)<br/>
21-
[setlocale, _wsetlocale](../c-runtime-library/reference/setlocale-wsetlocale.md)
21+
[`setlocale`, `_wsetlocale`](../c-runtime-library/reference/setlocale-wsetlocale.md)

docs/c-runtime-library/byte-classification.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ The predefined constants in the following table are defined in `<ctype.h>`.
2222
| [`isleadbyte`, `_isleadbyte_l`](../c-runtime-library/reference/isleadbyte-isleadbyte-l.md) | Lead byte; test result depends on `LC_CTYPE` category setting of current locale |
2323
| [`_ismbbalnum`, `_ismbbalnum_l`](../c-runtime-library/reference/ismbbalnum-ismbbalnum-l.md) | `isalnum || _ismbbkalnum` |
2424
| [`_ismbbalpha`, `_ismbbalpha_l`](../c-runtime-library/reference/ismbbalpha-ismbbalpha-l.md) | `isalpha || _ismbbkalpha` |
25-
| [`_ismbbgraph`, `_ismbbgraph_l`](../c-runtime-library/reference/ismbbgraph-ismbbgraph-l.md) | Same as `_ismbbprint`, but `_ismbbgraph` does not include the space character (0x20) |
25+
| [`_ismbbgraph`, `_ismbbgraph_l`](../c-runtime-library/reference/ismbbgraph-ismbbgraph-l.md) | Same as `_ismbbprint`, but `_ismbbgraph` doesn't include the space character (0x20) |
2626
| [`_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 |
2727
| [`_ismbbkana`, `_ismbbkana_l`](../c-runtime-library/reference/ismbbkana-ismbbkana-l.md) | Katakana (0xA1 - 0xDF), code page 932 only |
2828
| [`_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). |

docs/c-runtime-library/c-run-time-library-reference.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,9 +7,9 @@ helpviewer_keywords: ["CRT", "runtime libraries", "CRT, reference"]
77
---
88
# Microsoft C runtime library (CRT) reference
99

10-
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.
10+
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.
1111

12-
Sample programs are included in the individual reference topics for most routines in the library.
12+
Sample programs are included in the individual reference articles for most routines in the library.
1313

1414
## In This Section
1515

docs/c-runtime-library/cgets-cgetws.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -50,13 +50,13 @@ Storage location for data.
5050

5151
## Remarks
5252

53-
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]`.
53+
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]`.
5454

5555
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.
5656

5757
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).
5858

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

6161
### Generic-Text Routine Mappings
6262

@@ -120,4 +120,4 @@ Text = A line of input.
120120
## See also
121121

122122
[Console and Port I/O](../c-runtime-library/console-and-port-i-o.md)<br/>
123-
[_getch, _getwch](../c-runtime-library/reference/getch-getwch.md)
123+
[`_getch`, `_getwch`](../c-runtime-library/reference/getch-getwch.md)

docs/c-runtime-library/character-classification.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -8,9 +8,9 @@ ms.assetid: 3b6c8f0b-9701-407a-b384-9086698773f5
88
---
99
# Character Classification
1010

11-
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.)
11+
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.)
1212

13-
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.
13+
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.
1414

1515
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)`:
1616

docs/c-runtime-library/ciatan.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ This version of the `atan` function has a specialized calling convention that th
2626

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

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

3131
## Requirements
3232

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

3737
[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
38-
[atan, atanf, atanl, atan2, atan2f, atan2l](../c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md)
38+
[`atan`, `atanf`, `atanl`, `atan2`, `atan2f`, `atan2l`](../c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md)

docs/c-runtime-library/ciatan2.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ This version of the `atan2` function has a specialized calling convention that t
2626

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

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

3131
## Requirements
3232

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

3737
[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
38-
[atan, atanf, atanl, atan2, atan2f, atan2l](../c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md)
38+
[`atan`, `atanf`, `atanl`, `atan2`, `atan2f`, `atan2l`](../c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md)

docs/c-runtime-library/cicos.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -22,11 +22,11 @@ void __cdecl _CIcos();
2222

2323
## Remarks
2424

25-
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.
25+
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.
2626

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

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

3131
## Requirements
3232

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

3737
[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
38-
[cos, cosf, cosl](../c-runtime-library/reference/cos-cosf-cosl.md)<br/>
38+
[`cos`, `cosf`, `cosl`](../c-runtime-library/reference/cos-cosf-cosl.md)

docs/c-runtime-library/ciexp.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ This version of the `exp` function has a specialized calling convention that the
2626

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

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

3131
## Requirements
3232

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

3737
[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
38-
[exp, expf, expl](../c-runtime-library/reference/exp-expf.md)
38+
[`exp`, `expf`, `expl`](../c-runtime-library/reference/exp-expf.md)

docs/c-runtime-library/cifmod.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ This version of the `fmod` function has a specialized calling convention that th
2626

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

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

3131
## Requirements
3232

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

3737
[Alphabetical Function Reference](../c-runtime-library/reference/crt-alphabetical-function-reference.md)<br/>
38-
[fmod, fmodf](../c-runtime-library/reference/fmod-fmodf.md)
38+
[`fmod`, `fmodf`](../c-runtime-library/reference/fmod-fmodf.md)

docs/c-runtime-library/cilog.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -26,7 +26,7 @@ This version of the `log` function has a specialized calling convention that the
2626

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

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

3131
## Requirements
3232

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

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

0 commit comments

Comments
 (0)