Skip to content

Commit 02b5b31

Browse files
committed
Merging changes synced from https://github.com/MicrosoftDocs/cpp-docs-pr (branch live)
2 parents 1e433e7 + 0867d64 commit 02b5b31

File tree

12 files changed

+643
-73
lines changed

12 files changed

+643
-73
lines changed

docs/build/reference/c-cpp-prop-page.md

Lines changed: 489 additions & 0 deletions
Large diffs are not rendered by default.

docs/build/reference/jmc.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "/JMC (Just My Code debugging)"
33
ms.date: "08/20/2018"
4-
f1_keywords: ["/JMC"]
4+
f1_keywords: ["VC.Project.VCCLCompilerTool.SupportJustMyCode"]
55
helpviewer_keywords: ["/JMC compiler option [C++]", "Just my code [C++]", "-JMC compiler option [C++]", "User code, debugging", "JMC compiler option [C++]"]
66
---
77
# /JMC (Just My Code debugging)

docs/build/reference/qspectre.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "/Qspectre"
33
ms.date: "10/12/2018"
4-
f1_keywords: ["/Qspectre"]
4+
f1_keywords: ["VC.Project.VCCLCompilerTool.SpectreMitigation"]
55
helpviewer_keywords: ["/Qspectre"]
66
---
77
# /Qspectre

docs/build/reference/x-ignore-standard-include-paths.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
---
22
title: "/X (Ignore Standard Include Paths)"
3-
ms.date: "11/04/2016"
4-
f1_keywords: ["/x", "VC.Project.VCCLCompilerTool.OVERWRITEStandardIncludePath", "VC.Project.VCCLWCECompilerTool.OVERWRITEStandardIncludePath"]
3+
ms.date: "07/18/2019"
4+
f1_keywords: ["/x", "VC.Project.VCCLCompilerTool.OVERWRITEStandardIncludePath", "VC.Project.VCCLWCECompilerTool.OVERWRITEStandardIncludePath", "VC.Project.VCCLCompilerTool.IgnoreStandardIncludePath"]
55
helpviewer_keywords: ["/X compiler option [C++]", "include files, ignore standard path", "-X compiler option [C++]", "include directories, ignore standard", "X compiler option", "Ignore Standard Include Paths compiler option"]
66
ms.assetid: 16bdf2cc-c8dc-46e4-bdcc-f3caeba5e1ef
77
---

docs/standard-library/ccomplex.md

Lines changed: 17 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,26 +1,31 @@
11
---
22
title: "<ccomplex>"
3-
ms.date: "11/04/2016"
4-
f1_keywords: ["<ccomplex>"]
3+
ms.date: "07/11/2019"
4+
f1_keywords: ["<ccomplex>", "ccomplex"]
5+
helpviewer_keywords: ["ccomplex header"]
56
ms.assetid: a9fcb5f0-88e3-464b-a5fd-d1afb8cd7e6f
67
---
78
# &lt;ccomplex&gt;
89

9-
Includes the C++ Standard Library header [\<complex>](../standard-library/complex.md), which effectively includes the Standard C library header \<complex.h> and adds the associated names to the `std` namespace.
10+
Includes the C++ standard library header [\<complex>](complex.md).
1011

11-
## Syntax
12+
> [!NOTE]
13+
> The C standard library \<complex.h> header isn't included by \<ccomplex>, because it's effectively replaced by the C++ overloads in \<complex> and \<cmath>. That makes the \<ccomplex> header redundant. The \<complex.h> header is deprecated in C++. The \<ccomplex> header is deprecated in C++17 and removed in the draft C++20 standard.
1214
13-
```cpp
14-
#include <ccomplex>
15-
```
15+
## Requirements
1616

17-
## Remarks
17+
**Header:** \<ccomplex>
18+
19+
**Namespace:** std
1820

19-
Including this header ensures that the names declared using external linkage in the Standard C library header are declared in the `std` namespace.
21+
## Remarks
2022

21-
The name `clog`, which is declared in \<complex.h>, is not defined in the `std` namespace because of potential conflicts with the `clog` that is declared in [\<iostream>](../standard-library/iostream.md).
23+
The name `clog`, which is declared in \<complex.h>, isn't defined in the `std` namespace because of potential conflicts with the `clog` that's declared in [\<iostream>](iostream.md).
2224

2325
## See also
2426

25-
[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)<br/>
26-
[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)<br/>
27+
[\<complex>](complex.md)\
28+
[\<cmath>](cmath.md)\
29+
[Header files reference](cpp-standard-library-header-files.md)\
30+
[C++ standard library overview](cpp-standard-library-overview.md)\
31+
[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)

docs/standard-library/ciso646.md

Lines changed: 8 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,16 @@
11
---
22
title: "&lt;ciso646&gt;"
3-
ms.date: "11/04/2016"
4-
f1_keywords: ["<ciso646>"]
3+
ms.date: "07/11/2019"
4+
f1_keywords: ["<ciso646>", "ciso646"]
55
helpviewer_keywords: ["ciso646 header"]
66
ms.assetid: 9d570924-d299-4225-9a58-8c4c820f5903
77
---
88
# &lt;ciso646&gt;
99

10-
Includes the Standard C library header \<iso646.h> and adds the associated names to the `std` namespace.
10+
Includes the C standard library header \<iso646.h>, and adds the associated names to the `std` namespace.
1111

1212
> [!NOTE]
13-
> Use of this header is unnecessary in C++.
13+
> Because this compatibility header defines names that are keywords in C++, including it has no effect. The \<iso646.h> header is deprecated in C++. The \<ciso646> header is removed in the draft C++20 standard.
1414
1515
## Requirements
1616

@@ -20,10 +20,10 @@ Includes the Standard C library header \<iso646.h> and adds the associated names
2020

2121
## Remarks
2222

23-
Including this header ensures that the names declared using external linkage in the Standard C library header are declared in the `std` namespace.
23+
Including this header ensures that the names declared using external linkage in the C standard library header are declared in the `std` namespace.
2424

2525
## See also
2626

27-
[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)<br/>
28-
[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)<br/>
29-
[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)<br/>
27+
[Header files reference](cpp-standard-library-header-files.md)\
28+
[C++ standard library overview](cpp-standard-library-overview.md)\
29+
[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)
Lines changed: 54 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -1,35 +1,77 @@
11
---
2-
title: "C++ Standard Library Header Files"
3-
ms.date: "11/04/2016"
2+
title: "C++ standard library header files"
3+
ms.date: "07/12/2019"
44
helpviewer_keywords: ["header files, C++ Standard Library", "C++ Standard Library, header files"]
55
ms.assetid: e7bf497a-0f63-48d0-9b54-cb0eef4073c4
66
---
7-
# C++ Standard Library Header Files
7+
# C++ standard library header files
88

9-
Header files for the C++ Standard Library and extensions, by category.
9+
Header files for the C++ standard library and extensions, by category.
1010

1111
## Headers by category
1212

13+
::: moniker range=">=vs-2017"
14+
15+
| Category | Headers |
16+
| - | - |
17+
| [Algorithms](../cpp/algorithms-modern-cpp.md) | [\<algorithm>](algorithm.md), [\<cstdlib>](cstdlib.md), [\<numeric>](numeric.md) |
18+
| Atomic operations | [\<atomic>](atomic.md)<sup>11</sup> |
19+
| C library wrappers | [\<cassert>](cassert.md), [\<ccomplex>](ccomplex.md)<sup>11 a b</sup>, [\<cctype>](cctype.md), [\<cerrno>](cerrno.md), [\<cfenv>](cfenv.md)<sup>11</sup>, [\<cfloat>](cfloat.md), [\<cinttypes>](cinttypes.md)<sup>11</sup>, [\<ciso646>](ciso646.md)<sup>b</sup>, [\<climits>](climits.md), [\<clocale>](clocale.md), [\<cmath>](cmath.md), [\<csetjmp>](csetjmp.md), [\<csignal>](csignal.md), [\<cstdalign>](cstdalign.md)<sup>11 a b</sup>, [\<cstdarg>](cstdarg.md), [\<cstdbool>](cstdbool.md)<sup>11 a b</sup>, [\<cstddef>](cstddef.md), [\<cstdint>](cstdint.md)<sup>11</sup>, [\<cstdio>](cstdio.md), [\<cstdlib>](cstdlib.md), [\<cstring>](cstring.md), [\<ctgmath>](ctgmath.md)<sup>11 a b</sup>, [\<ctime>](ctime.md), [\<cuchar>](cuchar.md)<sup>11</sup>, [\<cwchar>](cwchar.md), [\<cwctype>](cwctype.md) |
20+
| Concepts | \<concepts><sup>20</sup> |
21+
| [Containers](../cpp/containers-modern-cpp.md) | |
22+
| Sequence containers | [\<array>](array.md)<sup>11</sup>, [\<deque>](deque.md), [\<forward_list>](forward-list.md)<sup>11</sup>, [\<list>](list.md), [\<vector>](vector.md) |
23+
| Ordered associative containers| [\<map>](map.md), [\<set>](set.md) |
24+
| Unordered associative containers | [\<unordered_map>](unordered-map.md)<sup>11</sup>, [\<unordered_set>](unordered-set.md)<sup>11</sup> |
25+
| Container adaptors | [\<queue>](queue.md), [\<stack>](stack.md) |
26+
| Container views | \<span><sup>20</sup> |
27+
| [Errors and exception handling](../cpp/errors-and-exception-handling-modern-cpp.md) | [\<cassert>](cassert.md), [\<exception>](exception.md), [\<stdexcept>](stdexcept.md), [\<system_error>](system-error.md)<sup>11</sup> |
28+
| General utilities | \<any><sup>17</sup>, [\<bitset>](bitset.md), \<charconv><sup>17</sup>, [\<cstdlib>](cstdlib.md), \<execution><sup>17</sup>, [\<functional>](functional.md), [\<memory>](memory.md), \<memory_resource><sup>17</sup>, \<optional><sup>17</sup>, [\<ratio>](ratio.md)<sup>11</sup>, [\<scoped_allocator>](scoped-allocator.md)<sup>11</sup>, [\<tuple>](tuple.md)<sup>11</sup>, [\<type_traits>](type-traits.md)<sup>11</sup>, [\<typeindex>](typeindex.md)<sup>11</sup>, [\<utility>](utility.md), \<variant><sup>17</sup> |
29+
| [I/O and formatting](../cpp/string-and-i-o-formatting-modern-cpp.md) | [\<cinttypes>](cinttypes.md)<sup>11</sup>, [\<cstdio>](cstdio.md), [\<filesystem>](filesystem.md)<sup>17</sup>, [\<fstream>](fstream.md), [\<iomanip>](iomanip.md), [\<ios>](ios.md), [\<iosfwd>](iosfwd.md), [\<iostream>](iostream.md), [\<istream>](istream.md), [\<ostream>](ostream.md), [\<sstream>](sstream.md), [\<streambuf>](streambuf.md), [\<strstream>](strstream.md)<sup>c</sup>, \<syncstream><sup>20</sup> |
30+
| Iterators | [\<iterator>](iterator.md) |
31+
| Language support | [\<cfloat>](cfloat.md), [\<climits>](climits.md), [\<codecvt>](codecvt.md)<sup>11 a</sup>, \<compare><sup>20</sup>, \<contract><sup>20</sup>, \<coroutine><sup>20</sup>, [\<csetjmp>](csetjmp.md), [\<csignal>](csignal.md), [\<cstdarg>](cstdarg.md), [\<cstddef>](cstddef.md), [\<cstdint>](cstdint.md)<sup>11</sup>, [\<cstdlib>](cstdlib.md), [\<exception>](exception.md), [\<initializer_list>](initializer-list.md)<sup>11</sup>, [\<limits>](limits.md), [\<new>](new.md), [\<typeinfo>](typeinfo.md), \<version><sup>20</sup> |
32+
| Localization | [\<clocale>](clocale.md), [\<codecvt>](codecvt.md)<sup>11 a</sup>, [\<cvt/wbuffer>](cvt-wbuffer.md), [\<cvt/wstring>](cvt-wstring.md), [\<locale>](locale.md) |
33+
| Math and numerics | \<bit><sup>20</sup>, [\<cfenv>](cfenv.md)<sup>11</sup>, [\<cmath>](cmath.md), [\<complex>](complex.md), [\<cstdlib>](cstdlib.md), [\<limits>](limits.md), [\<numeric>](numeric.md), [\<random>](random.md)<sup>11</sup>, [\<ratio>](ratio.md)<sup>11</sup>, [\<valarray>](valarray.md) |
34+
| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [\<allocators>](allocators-header.md), [\<memory>](memory.md), \<memory_resource><sup>17</sup>, [\<new>](new.md), [\<scoped_allocator>](scoped-allocator.md)<sup>11</sup> |
35+
| Multithreading | [\<atomic>](atomic.md)<sup>11</sup>, [\<condition_variable>](condition-variable.md)<sup>11</sup>, [\<future>](future.md)<sup>11</sup>, [\<mutex>](mutex.md)<sup>11</sup>, [\<shared_mutex>](shared-mutex.md)<sup>14</sup>, [\<thread>](thread.md)<sup>11</sup> |
36+
| Ranges | \<ranges><sup>20</sup> |
37+
| Regular expressions | [\<regex>](regex.md)<sup>11</sup> |
38+
| Strings and character data | [\<cctype>](cctype.md), [\<cstdlib>](cstdlib.md), [\<cstring>](cstring.md), [\<cuchar>](cuchar.md)<sup>11</sup>, [\<cwchar>](cwchar.md), [\<cwctype>](cwctype.md), [\<regex>](regex.md)<sup>11</sup>, [\<string>](string.md), [\<string_view>](string-view.md)<sup>17</sup> |
39+
| Time | [\<chrono>](chrono.md)<sup>11</sup>, [\<ctime>](ctime.md) |
40+
41+
<sup>11</sup> Added in the C++11 standard.\
42+
<sup>14</sup> Added in the C++14 standard.\
43+
<sup>17</sup> Added in the C++17 standard.\
44+
<sup>20</sup> Added in the draft C++20 standard.\
45+
<sup>a</sup> Deprecated in the C++17 standard.\
46+
<sup>b</sup> Removed in the draft C++20 standard.\
47+
<sup>c</sup> Deprecated in the C++98 standard.
48+
49+
::: moniker-end
50+
51+
::: moniker range="vs-2015"
52+
1353
|Category|Headers|
1454
|-|-|
1555
|[Algorithms](../cpp/algorithms-modern-cpp.md)|[\<algorithm>](algorithm.md)|
1656
|C library wrappers|[\<cassert>](cassert.md), [\<cctype>](cctype.md), [\<cerrno>](cerrno.md), [\<cfenv>](cfenv.md), [\<cfloat>](cfloat.md), [\<cinttypes>](cinttypes.md), [\<ciso646>](ciso646.md), [\<climits>](climits.md), [\<clocale>](clocale.md), [\<cmath>](cmath.md), [\<csetjmp>](csetjmp.md), [\<csignal>](csignal.md), [\<cstdarg>](cstdarg.md), [\<cstdbool>](cstdbool.md), [\<cstddef>](cstddef.md), [\<cstdint>](cstdint.md), [\<cstdio>](cstdio.md), [\<cstdlib>](cstdlib.md), [\<cstring>](cstring.md), [\<ctgmath>](ctgmath.md), [\<ctime>](ctime.md), [\<cwchar>](cwchar.md), [\<cwctype>](cwctype.md)|
1757
|[Containers](../cpp/containers-modern-cpp.md)||
18-
|Sequence containers|[\<array>](array.md), [\<deque>](deque.md), [<forward_list>](forward-list.md), [\<list>](list.md), [\<vector>](vector.md)|
58+
|Sequence containers|[\<array>](array.md), [\<deque>](deque.md), [\<forward_list>](forward-list.md), [\<list>](list.md), [\<vector>](vector.md)|
1959
|Ordered associative containers| [\<map>](map.md), [\<set>](set.md)|
20-
|Unordered associative containers|[<unordered_map>](unordered-map.md), [<unordered_set>](unordered-set.md)|
60+
|Unordered associative containers|[\<unordered_map>](unordered-map.md), [\<unordered_set>](unordered-set.md)|
2161
|Adaptor containers|[\<queue>](queue.md), [\<stack>](stack.md)|
22-
|[Errors and exception handling](../cpp/errors-and-exception-handling-modern-cpp.md)|[\<exception>](exception.md), [\<stdexcept>](stdexcept.md), [<system_error>](system-error.md)|
62+
|[Errors and exception handling](../cpp/errors-and-exception-handling-modern-cpp.md)|[\<exception>](exception.md), [\<stdexcept>](stdexcept.md), [\<system_error>](system-error.md)|
2363
|[I/O and formatting](../cpp/string-and-i-o-formatting-modern-cpp.md)|[\<filesystem>](filesystem.md), [\<fstream>](fstream.md), [\<iomanip>](iomanip.md), [\<ios>](ios.md), [\<iosfwd>](iosfwd.md), [\<iostream>](iostream.md), [\<istream>](istream.md), [\<ostream>](ostream.md), [\<sstream>](sstream.md), [\<streambuf>](streambuf.md), [\<strstream>](strstream.md)|
2464
|Iterators|[\<iterator>](iterator.md)|
2565
|Localization|[\<codecvt>](codecvt.md), [\<cvt/wbuffer>](cvt-wbuffer.md), [\<cvt/wstring>](cvt-wstring.md), [\<locale>](locale.md)|
2666
|Math and numerics|[\<complex>](complex.md), [\<limits>](limits.md), [\<numeric>](numeric.md), [\<random>](random.md), [\<ratio>](ratio.md), [\<valarray>](valarray.md)|
27-
|[Memory Management](../cpp/smart-pointers-modern-cpp.md)|[\<allocators>](allocators-header.md), [\<memory>](memory.md), [\<new>](new.md), [<scoped_allocator>](scoped-allocator.md)|
28-
|Multithreading|[\<atomic>](atomic.md), [<condition_variable>](condition-variable.md), [\<future>](future.md), [\<mutex>](mutex.md), [<shared_mutex>](shared-mutex.md), [\<thread>](thread.md)|
29-
|Other utilities|[\<bitset>](bitset.md), [\<chrono>](chrono.md), [\<functional>](functional.md), [<initializer_list>](initializer-list.md), [\<tuple>](tuple.md), [<type_traits>](type-traits.md), [\<typeinfo>](typeinfo.md), [\<typeindex>](typeindex.md), [\<utility>](utility.md)|
67+
|[Memory Management](../cpp/smart-pointers-modern-cpp.md)|[\<allocators>](allocators-header.md), [\<memory>](memory.md), [\<new>](new.md), [\<scoped_allocator>](scoped-allocator.md)|
68+
|Multithreading|[\<atomic>](atomic.md), [\<condition_variable>](condition-variable.md), [\<future>](future.md), [\<mutex>](mutex.md), [\<shared_mutex>](shared-mutex.md), [\<thread>](thread.md)|
69+
|Other utilities|[\<bitset>](bitset.md), [\<chrono>](chrono.md), [\<functional>](functional.md), [\<initializer_list>](initializer-list.md), [\<tuple>](tuple.md), [\<type_traits>](type-traits.md), [\<typeinfo>](typeinfo.md), [\<typeindex>](typeindex.md), [\<utility>](utility.md)|
3070
|Strings and character data|[\<regex>](regex.md), [\<string>](string.md), [\<string_view>](string-view.md)
3171

72+
::: moniker-end
73+
3274
## See also
3375

34-
[Using C++ Library Headers](using-cpp-library-headers.md)<br/>
35-
[C++ Standard Library](cpp-standard-library-reference.md)<br/>
76+
[Using C++ library headers](using-cpp-library-headers.md)\
77+
[C++ standard library](cpp-standard-library-reference.md)

docs/standard-library/cstdalign.md

Lines changed: 32 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,32 @@
1+
---
2+
title: "&lt;cstdalign&gt;"
3+
ms.date: "07/11/2019"
4+
f1_keywords: ["<cstdalign>", "cstdalign", "__alignas_is_defined", "__alignof_is_defined"]
5+
helpviewer_keywords: ["cstdalign header", "__alignas_is_defined", "__alignof_is_defined"]
6+
ms.assetid: 9d570924-d299-4225-9a58-8c4c820f5903
7+
---
8+
# &lt;cstdalign&gt;
9+
10+
In some C++ standard library implementations, this header includes the C standard library header \<stdalign.h>, and adds the associated names to the `std` namespace. Because that header isn't implemented in MSVC, the \<cstdalign> header defines compatibility macros `__alignas_is_defined` and `__alignof_is_defined`.
11+
12+
> [!NOTE]
13+
> Because the \<stdalign.h> header defines macros that are keywords in C++, including it has no effect. The \<stdalign.h> header is deprecated in C++. The \<cstdalign> header is deprecated in C++17 and removed in the draft C++20 standard.
14+
15+
## Requirements
16+
17+
**Header:** \<cstdalign>
18+
19+
**Namespace:** std
20+
21+
## Macros
22+
23+
| Macro | Description |
24+
| - | - |
25+
| `__alignas_is_defined` | A C compatibility macro that expands to the integer constant 1. |
26+
| `__alignof_is_defined` | A C compatibility macro that expands to the integer constant 1. |
27+
28+
## See also
29+
30+
[Header files reference](cpp-standard-library-header-files.md)\
31+
[C++ standard library overview](cpp-standard-library-overview.md)\
32+
[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)

docs/standard-library/cstdbool.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,16 @@
11
---
22
title: "&lt;cstdbool&gt;"
3-
ms.date: "11/04/2016"
3+
ms.date: "07/11/2019"
4+
f1_keywords: ["<cstdbool>", "cstdbool"]
5+
helpviewer_keywords: ["cstdbool header"]
46
ms.assetid: 44ccb8b2-d808-4715-8097-58ba09ab33ed
57
---
68
# &lt;cstdbool&gt;
79

8-
Includes the Standard C library header \<stdbool.h> and adds the associated names to the `std` namespace.
10+
Includes the C standard library header \<stdbool.h> and adds the associated names to the `std` namespace.
911

1012
> [!NOTE]
11-
> This header has been deprecated in C++ 17.
13+
> Because the \<stdbool.h> header defines macros that are keywords in C++, including it has no effect. The \<stdbool.h> header is deprecated in C++. The \<cstdbool> header is deprecated in C++17 and removed in the draft C++20 standard.
1214
1315
## Requirements
1416

@@ -18,10 +20,10 @@ Includes the Standard C library header \<stdbool.h> and adds the associated name
1820

1921
## Remarks
2022

21-
Including this header ensures that the names declared using external linkage in the Standard C library header are declared in the `std` namespace.
23+
Including this header ensures that the names declared using external linkage in the C standard library header are declared in the `std` namespace.
2224

2325
## See also
2426

25-
[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)<br/>
26-
[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)<br/>
27-
[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)<br/>
27+
[Header files reference](cpp-standard-library-header-files.md)\
28+
[C++ standard library overview](cpp-standard-library-overview.md)\
29+
[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md)

0 commit comments

Comments
 (0)