Skip to content

Commit 5ce76f5

Browse files
authored
Merge pull request #4244 from MicrosoftDocs/main638024023570439660sync_temp
Repo sync for protected CLA branch
2 parents 5886005 + 602a23f commit 5ce76f5

File tree

783 files changed

+6989
-7000
lines changed

Some content is hidden

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

783 files changed

+6989
-7000
lines changed

docs/c-runtime-library/32-bit-windows-time-date-formats.md

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -12,20 +12,20 @@ The file time and the date are stored individually, using unsigned integers as b
1212

1313
### Time
1414

15-
|Bit position:|0 1 2 3 4|5 6 7 8 9 A|B C D E F|
16-
|-------------------|-----------------------|---------------------------|-----------------------|
17-
|Length:|5|6|5|
18-
|Contents:|hours|minutes|2-second increments|
19-
|Value Range:|0-23|0-59|0-29 in 2-second intervals|
15+
| Bit position: | 0 1 2 3 4 | 5 6 7 8 9 A | B C D E F |
16+
|---|---|---|---|
17+
| Length: | 5 | 6 | 5 |
18+
| Contents: | hours | minutes | 2-second increments |
19+
| Value Range: | 0-23 | 0-59 | 0-29 in 2-second intervals |
2020

2121
### Date
2222

23-
|Bit position:|0 1 2 3 4 5 6|7 8 9 A|B C D E F|
24-
|-------------------|-------------------------------|-------------------|-----------------------|
25-
|Length:|7|4|5|
26-
|Contents:|year|month|day|
27-
|Value Range:|0-119|1-12|1-31|
28-
||(relative to 1980)|||
23+
| Bit position: | 0 1 2 3 4 5 6 | 7 8 9 A | B C D E F |
24+
|---|---|---|---|
25+
| Length: | 7 | 4 | 5 |
26+
| Contents: | year | month | day |
27+
| Value Range: | 0-119 | 1-12 | 1-31 |
28+
| | (relative to 1980) | | |
2929

3030
## See also
3131

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

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ api_name: ["_abnormal_termination"]
66
api_location: ["msvcr110.dll", "msvcr110_clr0400.dll", "msvcr90.dll", "msvcr120.dll", "msvcrt.dll", "msvcr80.dll", "msvcr100.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
9-
f1_keywords: ["_abnormal_termination"]
9+
f1_keywords: ["_abnormal_termination", "EXCPT/_abnormal_termination"]
1010
helpviewer_keywords: ["_abnormal_termination"]
1111
ms.assetid: 952970a4-9586-4c3d-807a-db729448c91c
1212
---
@@ -27,13 +27,13 @@ int _abnormal_termination(
2727
2828
## Remarks
2929
30-
`_abnormal_termination` is an internal function used to manage unwinding exceptions, and isn't 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
34-
|Routine|Required header|
35-
|-------------|---------------------|
36-
|_abnormal_termination|excpt.h|
34+
| Routine | Required header |
35+
|---|---|
36+
| **`_abnormal_termination`** | `<excpt.h>` |
3737
3838
## See also
3939

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

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,7 +6,7 @@ api_name: ["_wcmdln", "_acmdln"]
66
api_location: ["msvcrt.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
9-
f1_keywords: ["_acmdln", "acmdln", "_wcmdln", "wcmdln", "_tcmdln", "tcmdln"]
9+
f1_keywords: ["_acmdln", "_wcmdln", "_tcmdln"]
1010
helpviewer_keywords: ["_wcmdln global variable", "wcmdln global variable", "_acmdln global variable", "_tcmdln global variable", "tcmdln global variable", "acmdln global variable"]
1111
ms.assetid: 4fc0a6a0-3f93-420a-a19f-5276061ba539
1212
---
@@ -16,7 +16,7 @@ Internal CRT global variable. The command line.
1616

1717
## Syntax
1818

19-
```
19+
```C
2020
char * _acmdln;
2121
wchar_t * _wcmdln;
2222

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

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@ title: "ANSI C Conformance"
33
description: "An overview of Microsoft C runtime naming conventions for ANSI C conformance."
44
ms.date: "11/04/2016"
55
ms.topic: "conceptual"
6-
f1_keywords: ["Ansi"]
76
helpviewer_keywords: ["underscores, leading", "compatibility [C++], ANSI C", "conformance with ANSI C", "conventions [C++], Microsoft extensions", "underscores", "naming conventions [C++], Microsoft library", "ANSI [C++], C standard", "Microsoft extensions naming conventions"]
87
ms.assetid: 6be271bf-eecf-491a-a928-0ee2dd60e3b9
98
---

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

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -6,14 +6,14 @@ api_name: ["__wargv", "__argv", "__argc"]
66
api_location: ["msvcrt120.dll"]
77
api_type: ["DLLExport"]
88
topic_type: ["apiref"]
9-
f1_keywords: ["__argv", "__argc", "__wargv"]
9+
f1_keywords: ["__argc", "STDLIB/__argc", "__argv", "STDLIB/__argv", "__wargv", "STDLIB/__wargv"]
1010
helpviewer_keywords: ["__argv", "__wargv", "__argc"]
1111
ms.assetid: 17001b0a-04ad-4762-b3a6-c54847f02d7c
1212
no-loc: [__argc, __argv, __wargv, main, wmain]
1313
---
1414
# `__argc`, `__argv`, `__wargv`
1515

16-
The `__argc` global variable is a count of the number of command-line arguments passed to the program. `__argv` is a pointer to an array of single-byte-character or multi-byte-character strings that contain the program arguments, and `__wargv` is a pointer to an array of wide-character strings that contain the program arguments. These global variables provide the arguments to `main` or `wmain`.
16+
The **`__argc`** global variable is a count of the number of command-line arguments passed to the program. **`__argv`** is a pointer to an array of single-byte-character or multi-byte-character strings that contain the program arguments, and **`__wargv`** is a pointer to an array of wide-character strings that contain the program arguments. These global variables provide the arguments to `main` or `wmain`.
1717

1818
## Syntax
1919

@@ -25,23 +25,23 @@ extern wchar_t ** __wargv;
2525

2626
## Remarks
2727

28-
In a program that uses the `main` function, `__argc` and `__argv` are initialized at program startup by using the command line that's used to start the program. The command line is parsed into individual arguments, and wildcards are expanded. The count of arguments is assigned to `__argc` and the argument strings are allocated on the heap, and a pointer to the array of arguments is assigned to `__argv`. In a program compiled to use wide characters and a `wmain` function, the arguments are parsed and wildcards are expanded as wide-character strings, and a pointer to the array of argument strings is assigned to `__wargv`.
28+
In a program that uses the `main` function, **`__argc`** and **`__argv`** are initialized at program startup by using the command line that's used to start the program. The command line is parsed into individual arguments, and wildcards are expanded. The count of arguments is assigned to **`__argc`** and the argument strings are allocated on the heap, and a pointer to the array of arguments is assigned to **`__argv`**. In a program compiled to use wide characters and a `wmain` function, the arguments are parsed and wildcards are expanded as wide-character strings, and a pointer to the array of argument strings is assigned to **`__wargv`**.
2929

3030
For portable code, we recommend you use the arguments passed to `main` to get the command-line arguments in your program.
3131

3232
### Generic-text routine mappings
3333

34-
|Tchar.h routine|_UNICODE not defined|_UNICODE defined|
35-
|---------------------|---------------------------|-----------------------|
36-
|`__targv`|`__argv`|`__wargv`|
34+
| Tchar.h routine | `_UNICODE` not defined | `_UNICODE` defined |
35+
|---|---|---|
36+
| `__targv` | **`__argv`** | **`__wargv`** |
3737

3838
## Requirements
3939

40-
|Global variable|Required header|
41-
|---------------------|---------------------|
42-
|`__argc`, `__argv`, `__wargv`|\<stdlib.h>, \<cstdlib> (C++)|
40+
| Global variable | Required header |
41+
|---|---|
42+
| **`__argc`**, **`__argv`**, **`__wargv`** | \<stdlib.h>, \<cstdlib> (C++) |
4343

44-
`__argc`, `__argv`, and `__wargv` are Microsoft extensions. For compatibility information, see [Compatibility](./compatibility.md).
44+
**`__argc`**, **`__argv`**, and **`__wargv`** are Microsoft extensions. For compatibility information, see [Compatibility](./compatibility.md).
4545

4646
## See also
4747

docs/c-runtime-library/argument-access.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -12,11 +12,11 @@ The `va_arg`, `va_end`, and `va_start` macros provide access to function argumen
1212

1313
## Argument-access macros
1414

15-
|Macro|Use|
16-
|-----------|-------------------------------|
17-
|[`va_arg`](./reference/va-arg-va-copy-va-end-va-start.md)|Retrieve argument from list|
18-
|[`va_end`](./reference/va-arg-va-copy-va-end-va-start.md)|Reset pointer|
19-
|[`va_start`](./reference/va-arg-va-copy-va-end-va-start.md)|Set pointer to beginning of argument list|
15+
| Macro | Use |
16+
|---|---|
17+
| [`va_arg`](./reference/va-arg-va-copy-va-end-va-start.md) | Retrieve argument from list |
18+
| [`va_end`](./reference/va-arg-va-copy-va-end-va-start.md) | Reset pointer |
19+
| [`va_start`](./reference/va-arg-va-copy-va-end-va-start.md) | Set pointer to beginning of argument list |
2020

2121
## See also
2222

docs/c-runtime-library/buffer-manipulation.md

Lines changed: 10 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -11,16 +11,16 @@ Use these routines to work with areas of memory on a byte-by-byte basis.
1111

1212
## Buffer-manipulation routines
1313

14-
|Routine|Use|
15-
|-------------|---------|
16-
|[`_memccpy`](./reference/memccpy.md)|Copy characters from one buffer to another until given character or given number of characters has been copied|
17-
|[`memchr`, `wmemchr`](./reference/memchr-wmemchr.md)|Return pointer to first occurrence, within specified number of characters, of given character in buffer|
18-
|[`memcmp`, `wmemcmp`](./reference/memcmp-wmemcmp.md)|Compare specified number of characters from two buffers|
19-
|[`memcpy`, `wmemcpy`](./reference/memcpy-wmemcpy.md), [`memcpy_s`, `wmemcpy_s`](./reference/memcpy-s-wmemcpy-s.md)|Copy specified number of characters from one buffer to another|
20-
|[`_memicmp`, `_memicmp_l`](./reference/memicmp-memicmp-l.md)|Compare specified number of characters from two buffers without regard to case|
21-
|[`memmove`, `wmemmove`](./reference/memmove-wmemmove.md),[`memmove_s`, `wmemmove_s`](./reference/memmove-s-wmemmove-s.md)|Copy specified number of characters from one buffer to another|
22-
|[`memset`, `wmemset`](./reference/memset-wmemset.md)|Use given character to initialize specified number of bytes in the buffer|
23-
|[`_swab`](./reference/swab.md)|Swap bytes of data and store them at specified location|
14+
| Routine | Use |
15+
|---|---|
16+
| [`_memccpy`](./reference/memccpy.md) | Copy characters from one buffer to another until given character or given number of characters has been copied |
17+
| [`memchr`, `wmemchr`](./reference/memchr-wmemchr.md) | Return pointer to first occurrence, within specified number of characters, of given character in buffer |
18+
| [`memcmp`, `wmemcmp`](./reference/memcmp-wmemcmp.md) | Compare specified number of characters from two buffers |
19+
| [`memcpy`, `wmemcpy`](./reference/memcpy-wmemcpy.md), [`memcpy_s`, `wmemcpy_s`](./reference/memcpy-s-wmemcpy-s.md) | Copy specified number of characters from one buffer to another |
20+
| [`_memicmp`, `_memicmp_l`](./reference/memicmp-memicmp-l.md) | Compare specified number of characters from two buffers without regard to case |
21+
| [`memmove`, `wmemmove`](./reference/memmove-wmemmove.md),[`memmove_s`, `wmemmove_s`](./reference/memmove-s-wmemmove-s.md) | Copy specified number of characters from one buffer to another |
22+
| [`memset`, `wmemset`](./reference/memset-wmemset.md) | Use given character to initialize specified number of bytes in the buffer |
23+
| [`_swab`](./reference/swab.md) | Swap bytes of data and store them at specified location |
2424

2525
When the source and target areas overlap, only `memmove` is guaranteed to copy the full source properly.
2626

docs/c-runtime-library/bufsiz.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -2,15 +2,15 @@
22
description: "Learn more about: BUFSIZ"
33
title: "BUFSIZ"
44
ms.date: "11/04/2016"
5-
f1_keywords: ["BUFSIZ"]
5+
f1_keywords: ["BUFSIZ", "STDIO/BUFSIZ"]
66
helpviewer_keywords: ["BUFSIZ constant"]
77
ms.assetid: 94ac04a3-d154-476b-bd89-eefbc7b949ae
88
---
99
# `BUFSIZ`
1010

1111
## Syntax
1212

13-
```
13+
```C
1414
#include <stdio.h>
1515
```
1616

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

Lines changed: 0 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,6 @@ title: "Byte and Wide Streams"
33
description: "An overview of byte streams in the Microsoft C runtime library."
44
ms.date: "11/04/2016"
55
ms.topic: "conceptual"
6-
f1_keywords: ["Byte and Wide Streams"]
76
helpviewer_keywords: ["byte streams", "wide streams"]
87
ms.assetid: 61ef0587-4cbc-4eb8-aae5-4c298dbbc6f9
98
---

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

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@ Gets a character string from the console. More secure versions of these function
2222
2323
## Syntax
2424

25-
```
25+
```C
2626
char *_cgets(
2727
char *buffer
2828
);
@@ -46,30 +46,30 @@ Storage location for data.
4646

4747
## Return value
4848

49-
`_cgets` and `_cgetws` return a pointer to the start of the string, at `buffer[2]`. If `buffer` is `NULL`, these functions invoke the invalid parameter handler, as described in [Parameter validation](./parameter-validation.md). If execution is allowed to continue, they return `NULL` and set `errno` to `EINVAL`.
49+
**`_cgets`** and **`_cgetws`** return a pointer to the start of the string, at `buffer[2]`. If *`buffer`* is `NULL`, these functions invoke the invalid parameter handler, as described in [Parameter validation](./parameter-validation.md). If execution is allowed to continue, they return `NULL` and set `errno` to `EINVAL`.
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 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]`.
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

55-
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.
55+
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](./secure-template-overloads.md).
5858

5959
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

63-
|Tchar.h routine|`_UNICODE` and `_MBCS` not defined|`_MBCS` defined|`_UNICODE` defined|
64-
|---------------------|--------------------------------------|--------------------|-----------------------|
65-
|`_cgetts`|`_cgets`|`_cgets`|`_cgetws`|
63+
| Tchar.h routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined |
64+
|---|---|---|---|
65+
| `_cgetts` | **`_cgets`** | **`_cgets`** | **`_cgetws`** |
6666

6767
## Requirements
6868

69-
|Routine|Required header|
70-
|-------------|---------------------|
71-
|`_cgets`|\<conio.h>|
72-
|`_cgetws`|\<conio.h> or \<wchar.h>|
69+
| Routine | Required header |
70+
|---|---|
71+
| **`_cgets`** | \<conio.h> |
72+
| **`_cgetws`** | \<conio.h> or \<wchar.h> |
7373

7474
For more compatibility information, see [Compatibility](./compatibility.md).
7575

0 commit comments

Comments
 (0)