Skip to content

Commit d805162

Browse files
TaojunshenTylerMSFTv-rajagtPRMerger14PRMerger7
authored
6/20/2022 AM Publish (#4365)
* update requirements * update dates * updates * update year * removed exception detail * update version info * wording update * Link fixed. * Link fixed. * Link fixed. * Address more `this` issues found during #4327 fix (#4333) * Address more `this` issues found during #4327 fix * Fix missed code formatting * updating this keyword * Acrolinx update * Arm64EC ABI * Fix bot comments * Acrolinx and style updates * update after review * Add EC function name decoration section * Remove duplicated typedef * Add decorated names updates * update after review * Update per David Lowndes issue * Also update merge modules article * fix typo * PR feedback * updating this keyword * resolving error * Fix a typo in Decorated names * Typo "MSBUILD.exe"→"MSBuild.exe" https://docs.microsoft.com/en-us/cpp/build/reference/mp-build-with-multiple-processes?view=msvc-170 https://github.com/MicrosoftDocs/cpp-docs/blob/main/docs/build/reference/mp-build-with-multiple-processes.md #PingMSFTDocs * Ranges (#4314) * draft * add begin() * add stubs * work * added art * days work * finish draft of namespace level functions * fix filenames * cleanup pass * minor update * stash * clean up adaptors sectin * start discussion of views and range adaptors * fix return value heading * tech review * acrolinx type fixes * Update docs/standard-library/range-functions.md Co-authored-by: Casey Carter <[email protected]> * tech review2 * fix typo * one more typo Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: Casey Carter <[email protected]> * Update cmfctoolbar-class.md Description of m_bDontScaleImages was unhelpful (like far to much of Microsoft docs that simply document "DoFoo" as "Does Foo" instead of explaining what "Foo" is and why somebody would want to do it or not.) I copied the documentation from the BCGSoft docs for this. Since much of the MFC was obtained from them, we should use their documentation more. * update after review * Update cmfctoolbar-class.md Tightened up the text a bit and added code escape for TRUE * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4347) * 6/8/2022 AM Publish (#4339) * update requirements * update dates * updates * update year * removed exception detail * update version info * wording update * Link fixed. * Link fixed. * Link fixed. * Address more `this` issues found during #4327 fix (#4333) * Address more `this` issues found during #4327 fix * Fix missed code formatting Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> * 6/9/2022 AM Publish (#4342) * update requirements * update dates * updates * update year * removed exception detail * update version info * wording update * Link fixed. * Link fixed. * Link fixed. * Address more `this` issues found during #4327 fix (#4333) * Address more `this` issues found during #4327 fix * Fix missed code formatting * updating this keyword * Acrolinx update * update after review * Remove duplicated typedef * update after review * Update per David Lowndes issue * Also update merge modules article * fix typo Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: rachana-satao <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: Tomohiro Endo <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: PRMerger16 <[email protected]> Co-authored-by: Tamara K <[email protected]> Co-authored-by: Haig MacGregor <[email protected]> * 6/10/2022 AM Publish (#4345) * update requirements * update dates * updates * update year * removed exception detail * update version info * wording update * Link fixed. * Link fixed. * Link fixed. * Address more `this` issues found during #4327 fix (#4333) * Address more `this` issues found during #4327 fix * Fix missed code formatting * updating this keyword * Acrolinx update * update after review * Remove duplicated typedef * update after review * Update per David Lowndes issue * Also update merge modules article * fix typo Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: rachana-satao <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: Tomohiro Endo <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: PRMerger16 <[email protected]> Co-authored-by: Tamara K <[email protected]> Co-authored-by: Haig MacGregor <[email protected]> * Update cmfctoolbar-class.md Description of m_bDontScaleImages was unhelpful (like far to much of Microsoft docs that simply document "DoFoo" as "Does Foo" instead of explaining what "Foo" is and why somebody would want to do it or not.) I copied the documentation from the BCGSoft docs for this. Since much of the MFC was obtained from them, we should use their documentation more. * Update cmfctoolbar-class.md Tightened up the text a bit and added code escape for TRUE Co-authored-by: Taojunshen <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: rachana-satao <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: Tomohiro Endo <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: PRMerger16 <[email protected]> Co-authored-by: Tamara K <[email protected]> Co-authored-by: Haig MacGregor <[email protected]> Co-authored-by: Scot Brennecke <[email protected]> * Confirm merge from FromPublicMasterBranch to main to sync with https://github.com/MicrosoftDocs/cpp-docs (branch main) (#4348) * 6/8/2022 AM Publish (#4339) * update requirements * update dates * updates * update year * removed exception detail * update version info * wording update * Link fixed. * Link fixed. * Link fixed. * Address more `this` issues found during #4327 fix (#4333) * Address more `this` issues found during #4327 fix * Fix missed code formatting Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> * 6/9/2022 AM Publish (#4342) * update requirements * update dates * updates * update year * removed exception detail * update version info * wording update * Link fixed. * Link fixed. * Link fixed. * Address more `this` issues found during #4327 fix (#4333) * Address more `this` issues found during #4327 fix * Fix missed code formatting * updating this keyword * Acrolinx update * update after review * Remove duplicated typedef * update after review * Update per David Lowndes issue * Also update merge modules article * fix typo Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: rachana-satao <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: Tomohiro Endo <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: PRMerger16 <[email protected]> Co-authored-by: Tamara K <[email protected]> Co-authored-by: Haig MacGregor <[email protected]> * 6/10/2022 AM Publish (#4345) * update requirements * update dates * updates * update year * removed exception detail * update version info * wording update * Link fixed. * Link fixed. * Link fixed. * Address more `this` issues found during #4327 fix (#4333) * Address more `this` issues found during #4327 fix * Fix missed code formatting * updating this keyword * Acrolinx update * update after review * Remove duplicated typedef * update after review * Update per David Lowndes issue * Also update merge modules article * fix typo Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: rachana-satao <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: Tomohiro Endo <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: PRMerger16 <[email protected]> Co-authored-by: Tamara K <[email protected]> Co-authored-by: Haig MacGregor <[email protected]> * Typo "MSBUILD.exe"→"MSBuild.exe" https://docs.microsoft.com/en-us/cpp/build/reference/mp-build-with-multiple-processes?view=msvc-170 https://github.com/MicrosoftDocs/cpp-docs/blob/main/docs/build/reference/mp-build-with-multiple-processes.md #PingMSFTDocs * Update cmfctoolbar-class.md Description of m_bDontScaleImages was unhelpful (like far to much of Microsoft docs that simply document "DoFoo" as "Does Foo" instead of explaining what "Foo" is and why somebody would want to do it or not.) I copied the documentation from the BCGSoft docs for this. Since much of the MFC was obtained from them, we should use their documentation more. * 6/13/2022 AM Publish (#4346) * update requirements * update dates * updates * update year * removed exception detail * update version info * wording update * Link fixed. * Link fixed. * Link fixed. * Address more `this` issues found during #4327 fix (#4333) * Address more `this` issues found during #4327 fix * Fix missed code formatting * updating this keyword * Acrolinx update * update after review * Remove duplicated typedef * update after review * Update per David Lowndes issue * Also update merge modules article * fix typo * Ranges (#4314) * draft * add begin() * add stubs * work * added art * days work * finish draft of namespace level functions * fix filenames * cleanup pass * minor update * stash * clean up adaptors sectin * start discussion of views and range adaptors * fix return value heading * tech review * acrolinx type fixes * Update docs/standard-library/range-functions.md Co-authored-by: Casey Carter <[email protected]> * tech review2 * fix typo * one more typo Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: Casey Carter <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: rachana-satao <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: Tomohiro Endo <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: PRMerger16 <[email protected]> Co-authored-by: Tamara K <[email protected]> Co-authored-by: Haig MacGregor <[email protected]> Co-authored-by: Casey Carter <[email protected]> * Update cmfctoolbar-class.md Tightened up the text a bit and added code escape for TRUE Co-authored-by: Taojunshen <[email protected]> Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: rachana-satao <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: Tomohiro Endo <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: PRMerger16 <[email protected]> Co-authored-by: Tamara K <[email protected]> Co-authored-by: Haig MacGregor <[email protected]> Co-authored-by: Hiroshi Yoshioka <[email protected]> Co-authored-by: Scot Brennecke <[email protected]> Co-authored-by: Casey Carter <[email protected]> * Consolidate manifest docs, updates for 3974, 3972, 3954 (#4343) * Consolidate manifest docs, 3972 3954 * Fix build warning * Consolidate See also sections * Add function overloading for 3974 * Fix broken anchor links for redirects * update after review * use capitalized ARM * update docs to clarify volatile flag for ARM64EC * update after review * Add vectorcall doc update for ARM64EC * update F1 help metadata (#4352) * update F1 help metadata * small fixes * fix metadata Co-authored-by: TylerMSFT <[email protected]> * Followup for cpp-docs PR 3977 (#4355) * Edits to improve SEO and usability. (#4350) * Edits to improve SEO and usability. * Incorporate feedback. * resolving blocking issues * updating this keyword -3 (#4353) * updating this keyword-3 * update after review * resolving validation warning * update after review * fix examples * Address C4743 weirdness per 3955 (#4359) * updating this keyword-4 * Acrolinx update * Acrolinx update * Acrolix update * update after review Co-authored-by: TylerMSFT <[email protected]> Co-authored-by: v-rajagt <[email protected]> Co-authored-by: PRMerger14 <[email protected]> Co-authored-by: PRMerger7 <[email protected]> Co-authored-by: PRMerger12 <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: opbld17 <[email protected]> Co-authored-by: rachana-satao <[email protected]> Co-authored-by: opbld16 <[email protected]> Co-authored-by: Victor Tong <[email protected]> Co-authored-by: Colin Robertson <[email protected]> Co-authored-by: Tomohiro Endo <[email protected]> Co-authored-by: Tyler Whitney <[email protected]> Co-authored-by: opbld15 <[email protected]> Co-authored-by: PRMerger16 <[email protected]> Co-authored-by: Tamara K <[email protected]> Co-authored-by: Haig MacGregor <[email protected]> Co-authored-by: Hiroshi Yoshioka <[email protected]> Co-authored-by: Casey Carter <[email protected]> Co-authored-by: Scot Brennecke <[email protected]> Co-authored-by: Feng Xu <[email protected]> Co-authored-by: Paula Miller <[email protected]> Co-authored-by: Tim Sherer <[email protected]> Co-authored-by: Colin Cooper <[email protected]> Co-authored-by: PRMerger13 <[email protected]> Co-authored-by: Laura Brenner <[email protected]>
1 parent 7a9da95 commit d805162

11 files changed

+75
-55
lines changed

docs/standard-library/match-results-class.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
---
22
description: "Learn more about: match_results Class"
33
title: "match_results Class"
4-
ms.date: "09/10/2018"
4+
ms.date: 06/17/2022
55
f1_keywords: ["regex/std::match_results"]
66
helpviewer_keywords: ["match_results class"]
77
ms.assetid: b504fdca-e5dd-429d-9960-6e27c9167fa6
8+
ms.custom: devdivchpfy22
89
---
10+
911
# match_results Class
1012

1113
Holds a sequence of submatches.
@@ -416,7 +418,7 @@ Index of the submatch.
416418

417419
### Remarks
418420

419-
The member function returns a reference to element *n* of the controlled sequence, or a reference to an empty `sub_match` object if `size() <= n` or if capture group *n* was not part of the match.
421+
The member function returns a reference to element *n* of the controlled sequence, or a reference to an empty `sub_match` object if `size() <= n` or if capture group *n* wasn't part of the match.
420422

421423
## <a name="position"></a> match_results::position
422424

@@ -539,7 +541,7 @@ The match_results object to swap with.
539541
540542
### Remarks
541543
542-
The member function swaps the contents of **`*this`** and *right* in constant time and does not throw exceptions.
544+
The member function swaps the contents of **`*this`** and *right* in constant time and doesn't throw exceptions.
543545
544546
## <a name="value_type"></a> match_results::value_type
545547

docs/standard-library/move-iterator-class.md

Lines changed: 8 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,16 @@
11
---
22
description: "Learn more about: move_iterator Class"
33
title: "move_iterator Class"
4-
ms.date: "03/27/2019"
4+
ms.date: 06/17/2022
55
f1_keywords: ["iterator/std::move_iterator", "iterator/std::move_iterator::iterator_type", "iterator/std::move_iterator::iterator_category", "iterator/std::move_iterator::value_type", "iterator/std::move_iterator::difference_type", "iterator/std::move_iterator::pointer", "iterator/std::move_iterator::reference", "iterator/std::move_iterator::base"]
66
helpviewer_keywords: ["std::move_iterator [C++]", "std::move_iterator [C++], iterator_type", "std::move_iterator [C++], iterator_category", "std::move_iterator [C++], value_type", "std::move_iterator [C++], difference_type", "std::move_iterator [C++], pointer", "std::move_iterator [C++], reference", "std::move_iterator [C++], base"]
77
ms.assetid: a5e5cdd8-a264-4c6b-9f9c-68b0e8edaab7
8+
ms.custom: devdivchpfy22
89
---
10+
911
# move_iterator Class
1012

11-
Class template `move_iterator` is a wrapper for an iterator. The move_iterator provides the same behavior as the iterator it wraps (stores), except it turns the stored iterators dereference operator into an rvalue reference, turning a copy into a move. For more information about rvalues, see [Rvalue Reference Declarator: &&](../cpp/rvalue-reference-declarator-amp-amp.md).
13+
Class template `move_iterator` is a wrapper for an iterator. The move_iterator provides the same behavior as the iterator it wraps (stores), except it turns the stored iterator's dereference operator into an rvalue reference, turning a copy into a move. For more information about rvalues, see [Rvalue Reference Declarator: &&](../cpp/rvalue-reference-declarator-amp-amp.md).
1214

1315
## Syntax
1416

@@ -20,7 +22,7 @@ class move_iterator;
2022

2123
The class template describes an object that behaves like an iterator except when dereferenced. It stores a random-access iterator of type `Iterator`, accessed by way of the member function `base()`. All operations on a `move_iterator` are performed directly on the stored iterator, except that the result of `operator*` is implicitly cast to `value_type&&` to make an rvalue reference.
2224

23-
A `move_iterator` might be capable of operations that are not defined by the wrapped iterator. These operations should not be used.
25+
A `move_iterator` might be capable of operations that aren't defined by the wrapped iterator. These operations shouldn't be used.
2426

2527
### Constructors
2628

@@ -50,8 +52,8 @@ A `move_iterator` might be capable of operations that are not defined by the wra
5052
|Operator|Description|
5153
|-|-|
5254
|[move_iterator::operator*](#op_star)|Returns `(reference)*base().`|
53-
|[move_iterator::operator++](#op_add_add)|Increments the stored iterator. Exact behavior depends on whether it is a preincrement or a postincrement operation.|
54-
|[move_iterator::operator--](#operator--)|Decrements the stored iterator. Exact behavior depends on whether it is a predecrement or a postdecrement operation.|
55+
|[move_iterator::operator++](#op_add_add)|Increments the stored iterator. Exact behavior depends on whether it's a preincrement or a postincrement operation.|
56+
|[move_iterator::operator--](#operator--)|Decrements the stored iterator. Exact behavior depends on whether it's a predecrement or a postdecrement operation.|
5557
|[`move_iterator::operator->`](#op_arrow)|Returns `&**this`.|
5658
|[move_iterator::operator-](#operator-)|Returns `move_iterator(*this) -=` by first subtracting the right-hand value from the current position.|
5759
|[move_iterator::operator[]](#op_at)|Returns `(reference)*(*this + off)`. Allows you to specify an offset from the current base to obtain the value at that location.|
@@ -170,7 +172,7 @@ The operator evaluates `*this += -_Off`. Then returns **`*this`**.
170172

171173
## <a name="op_add_add"></a> move_iterator::operator++
172174

173-
Increments the stored iterator that belongs to this `move_iterator.` The current element is accessed by the postincrement operator. The next element is accessed by the preincrement operator.
175+
Increments the stored iterator that belongs to this `move_iterator`. The current element is accessed by the postincrement operator. The next element is accessed by the preincrement operator.
174176

175177
```cpp
176178
move_iterator& operator++();

docs/standard-library/nested-exception-class.md

Lines changed: 3 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
---
22
description: "Learn more about: nested_exception Class"
33
title: "nested_exception Class"
4-
ms.date: "11/04/2016"
4+
ms.date: 06/17/2022
55
f1_keywords: ["exception/std::nested_exception"]
66
helpviewer_keywords: ["nested_exception class"]
77
ms.assetid: 5ae2c4ef-c7ad-4469-8a9e-a773e86bb000
8+
ms.custom: devdivchpfy22
89
---
10+
911
# nested_exception Class
1012

1113
The class describes an exception for use with multiple inheritance. It captures the currently handled exception and stores it for later use.

docs/standard-library/ostream-iterator-class.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
---
22
description: "Learn more about: ostream_iterator Class"
33
title: "ostream_iterator Class"
4-
ms.date: "11/04/2016"
4+
ms.date: 06/17/2022
55
f1_keywords: ["iterator/std::ostream_iterator", "iterator/std::ostream_iterator::char_type", "iterator/std::ostream_iterator::ostream_type", "iterator/std::ostream_iterator::traits_type"]
66
helpviewer_keywords: ["std::ostream_iterator [C++]", "std::ostream_iterator [C++], char_type", "std::ostream_iterator [C++], ostream_type", "std::ostream_iterator [C++], traits_type"]
77
ms.assetid: 24d842d3-9f45-4bf6-a697-62f5968f5a03
8+
ms.custom: devdivchpfy22
89
---
10+
911
# ostream_iterator Class
1012

1113
The class template ostream_iterator describes an output iterator object that writes successive elements onto the output stream with the extraction `operator <<`.
@@ -121,7 +123,7 @@ A reference to the `ostream_iterator`.
121123

122124
### Remarks
123125

124-
The requirements for an output iterator that the `ostream_iterator` must satisfy require only the expression \* *ii* = *t* be valid and says nothing about the **`operator`** or the `operator=` on their own. The member operator in this implementation returns **\*this**.
126+
The requirements for an output iterator that the `ostream_iterator` must satisfy require only the expression \* *ii* = *t* be valid and says nothing about the **`operator`** or the `operator=` on their own. The member operator in this implementation returns **`*this`**.
125127

126128
### Example
127129

@@ -171,7 +173,7 @@ A reference to the `ostream_iterator`.
171173

172174
### Remarks
173175

174-
These member operators both return **\*this**.
176+
These member operators both return **`*this`**.
175177

176178
### Example
177179

docs/standard-library/packaged-task-class.md

Lines changed: 9 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,11 +1,13 @@
11
---
22
description: "Learn more about: packaged_task Class"
33
title: "packaged_task Class"
4-
ms.date: "11/04/2016"
4+
ms.date: 06/17/2022
55
f1_keywords: ["future/std::packaged_task", "future/std::packaged_task::packaged_task", "future/std::packaged_task::get_future", "future/std::packaged_task::make_ready_at_thread_exit", "future/std::packaged_task::reset", "future/std::packaged_task::swap", "future/std::packaged_task::valid", "future/std::packaged_task::operator()", "future/std::packaged_task::operator bool"]
66
ms.assetid: 0a72cbe3-f22a-4bfe-8e50-dcb268c98780
77
helpviewer_keywords: ["std::packaged_task [C++]", "std::packaged_task [C++], packaged_task", "std::packaged_task [C++], get_future", "std::packaged_task [C++], make_ready_at_thread_exit", "std::packaged_task [C++], reset", "std::packaged_task [C++], swap", "std::packaged_task [C++], valid"]
8+
ms.custom: devdivchpfy22
89
---
10+
911
# packaged_task Class
1012

1113
Describes an *asynchronous provider* that is a call wrapper whose call signature is `Ty(ArgTypes...)`. Its *associated asynchronous state* holds a copy of its callable object in addition to the potential result.
@@ -33,7 +35,7 @@ class packaged_task;
3335
|[get_future](#get_future)|Returns a [future](../standard-library/future-class.md) object that has the same associated asynchronous state.|
3436
|[make_ready_at_thread_exit](#make_ready_at_thread_exit)|Calls the callable object that's stored in the associated asynchronous state and atomically stores the returned value.|
3537
|[reset](#reset)|Replaces the associated asynchronous state.|
36-
|[swap](#swap)|Exchanges the associated asynchronous state with that of a specified object.|
38+
|[swap](#swap)|Exchanges the associated asynchronous state with a specified object.|
3739
|[valid](#valid)|Specifies whether the object has an associated asynchronous state.|
3840

3941
### Public Operators
@@ -60,7 +62,7 @@ future<Ty> get_future();
6062

6163
### Remarks
6264

63-
If the `packaged_task` object does not have an associated asynchronous state, this method throws a [future_error](../standard-library/future-error-class.md) that has an error code of `no_state`.
65+
If the `packaged_task` object doesn't have an associated asynchronous state, this method throws a [future_error](../standard-library/future-error-class.md) that has an error code of `no_state`.
6466

6567
If this method has already been called for a `packaged_task` object that has the same associated asynchronous state, the method throws a `future_error` that has an error code of `future_already_retrieved`.
6668

@@ -80,7 +82,7 @@ If this method or [make_ready_at_thread_exit](#make_ready_at_thread_exit) has al
8082
8183
Otherwise, this operator calls `INVOKE(fn, args..., Ty)`, where *fn* is the callable object that's stored in the associated asynchronous state. Any returned value is stored atomically as the returned result of the associated asynchronous state.
8284
83-
In contrast to [packaged_task::operator()](#op_call), the associated asynchronous state is not set to `ready` until after all thread-local objects in the calling thread have been destroyed. Typically, threads that are blocked on the associated asynchronous state are not unblocked until the calling thread exits.
85+
In contrast to [packaged_task::operator()](#op_call), the associated asynchronous state isn't set to `ready` until after all thread-local objects in the calling thread have been destroyed. Typically, threads that are blocked on the associated asynchronous state aren't unblocked until the calling thread exits.
8486
8587
## <a name="op_eq"></a> packaged_task::operator=
8688
@@ -177,7 +179,7 @@ Destroys a `packaged_task` object.
177179

178180
### Remarks
179181

180-
If the *associated asynchronous state* is not *ready*, the destructor stores a [future_error](../standard-library/future-error-class.md) exception that has an error code of `broken_promise` as the result in the associated asynchronous state, and any threads that are blocked on the associated asynchronous state become unblocked.
182+
If the *associated asynchronous state* isn't *ready*, the destructor stores a [future_error](../standard-library/future-error-class.md) exception that has an error code of `broken_promise` as the result in the associated asynchronous state, and any threads that are blocked on the associated asynchronous state become unblocked.
181183

182184
## <a name="reset"></a> packaged_task::reset
183185

@@ -189,11 +191,11 @@ void reset();
189191

190192
### Remarks
191193

192-
In effect, this method executes `*this = packaged_task(move(fn))`, where *fn* is the function object that's stored in the associated asynchronous state for this object. Therefore, the state of the object is cleared, and [get_future](#get_future), [operator()](#op_call), and [make_ready_at_thread_exit](#make_ready_at_thread_exit) can be called as if on a newly-constructed object.
194+
In effect, this method executes `*this = packaged_task(move(fn))`, where *fn* is the function object that's stored in the associated asynchronous state for this object. Therefore, the state of the object is cleared, and [get_future](#get_future), [operator()](#op_call), and [make_ready_at_thread_exit](#make_ready_at_thread_exit) can be called as if on a newly constructed object.
193195

194196
## <a name="swap"></a> packaged_task::swap
195197

196-
Exchanges the associated asynchronous state with that of a specified object.
198+
Exchanges the associated asynchronous state with a specified object.
197199

198200
```cpp
199201
void swap(packaged_task& Right) noexcept;

docs/standard-library/path-class.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,11 @@
11
---
22
description: "Learn more about: path Class"
33
title: "path Class"
4-
ms.date: "09/27/2018"
4+
ms.date: 06/17/2022
55
f1_keywords: ["filesystem/std::experimental::filesystem::path"]
6+
ms.custom: devdivchpfy22
67
---
8+
79
# `path` Class
810

911
The **`path`** class stores an object of type `string_type`, called `myname` here for the purposes of exposition, suitable for use as a pathname. `string_type` is a synonym for `basic_string<value_type>`, where `value_type` is a synonym for **`wchar_t`** on Windows or **`char`** on POSIX.
@@ -633,7 +635,7 @@ static constexpr value_type preferred_separator == '/';
633635

634636
### Remarks
635637

636-
Note that it's equally permissible in most contexts under Windows to use `L'/'` in its place.
638+
It's equally permissible in most contexts under Windows to use `L'/'` in its place.
637639

638640
## <a name="relative_path"></a> `path::relative_path`
639641

docs/standard-library/promise-class.md

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,11 @@
11
---
22
description: "Learn more about: promise Class"
33
title: "promise Class"
4-
ms.date: "10/18/2018"
4+
ms.date: 06/17/2022
55
f1_keywords: ["future/std::promise", "future/std::promise::promise", "future/std::promise::get_future", "future/std::promise::set_exception", "future/std::promise::set_exception_at_thread_exit", "future/std::promise::set_value", "future/std::promise::set_value_at_thread_exit", "future/std::promise::swap"]
66
ms.assetid: 2931558c-d94a-4ba1-ac4f-20bf7b6e23f9
77
helpviewer_keywords: ["std::promise [C++]", "std::promise [C++], promise", "std::promise [C++], get_future", "std::promise [C++], set_exception", "std::promise [C++], set_exception_at_thread_exit", "std::promise [C++], set_value", "std::promise [C++], set_value_at_thread_exit", "std::promise [C++], swap"]
8+
ms.custom: devdivchpfy22
89
---
910
# promise Class
1011

@@ -101,7 +102,7 @@ promise(promise&& Other) noexcept;
101102
### Parameters
102103
103104
*Al*\
104-
A memory allocator. See [\<allocators>](../standard-library/allocators-header.md) for more information.
105+
A memory allocator. For more information about allocators, see [\<allocators>](../standard-library/allocators-header.md).
105106
106107
*Other*\
107108
A `promise` object.
@@ -154,7 +155,7 @@ If the promise object has no *associated asynchronous state*, this method throws
154155
155156
If [set_exception](#set_exception), `set_exception_at_thread_exit`, [set_value](#set_value), or [set_value_at_thread_exit](#set_value_at_thread_exit) has already been called for a `promise` object that has the same associated asynchronous state, this method throws a `future_error` that has an error code of `promise_already_satisfied`.
156157
157-
In contrast to [set_exception](#set_exception), this method does not set the associated asynchronous state to ready until after all thread-local objects in the current thread have been destroyed. Typically, threads that are blocked on the associated asynchronous state are not unblocked until the current thread exits.
158+
In contrast to [set_exception](#set_exception), this method doesn't set the associated asynchronous state to ready until after all thread-local objects in the current thread have been destroyed. Typically, threads that are blocked on the associated asynchronous state aren't unblocked until the current thread exits.
158159
159160
## <a name="set_value"></a> promise::set_value
160161
@@ -180,9 +181,9 @@ If [set_exception](#set_exception), [set_exception_at_thread_exit](#set_exceptio
180181

181182
As a result of this method, any threads that are blocked on the associated asynchronous state become unblocked.
182183

183-
The first method also throws any exception that is thrown when *Val* is copied into the associated asynchronous state. In this situation, the associated asynchronous state is not set to ready.
184+
The first method also throws any exception that is thrown when *Val* is copied into the associated asynchronous state. In this situation, the associated asynchronous state isn't set to ready.
184185

185-
The second method also throws any exception that is thrown when *Val* is moved into the associated asynchronous state. In this situation, the associated asynchronous state is not set to ready.
186+
The second method also throws any exception that is thrown when *Val* is moved into the associated asynchronous state. In this situation, the associated asynchronous state isn't set to ready.
186187

187188
For the partial specialization `promise<Ty&>`, the stored value is in effect a reference to *Val*.
188189

@@ -210,7 +211,7 @@ If the promise object has no *associated asynchronous state*, this method throws
210211
211212
If [set_exception](#set_exception), [set_exception_at_thread_exit](#set_exception_at_thread_exit), [set_value](#set_value), or `set_value_at_thread_exit` has already been called for a `promise` object that has the same associated asynchronous state, this method throws a `future_error` that has an error code of `promise_already_satisfied`.
212213
213-
In contrast to `set_value`, the associated asynchronous state is not set to ready until after all thread-local objects in the current thread have been destroyed. Typically, threads that are blocked on the associated asynchronous state are not unblocked until the current thread exits.
214+
In contrast to `set_value`, the associated asynchronous state isn't set to ready until after all thread-local objects in the current thread have been destroyed. Typically, threads that are blocked on the associated asynchronous state aren't unblocked until the current thread exits.
214215
215216
The first method also throws any exception that is thrown when *Val* is copied into the associated asynchronous state.
216217

0 commit comments

Comments
 (0)