Difference between revisions of "cpp/utility/in place"
From cppreference.com
m ([email protected]@, and swapped two paragraphs.) |
m (→See also: +sorted_*) |
||
| Line 1: | Line 1: | ||
| − | {{cpp/title|in_place|in_place_type|in_place_index|in_place_t|in_place_type_t|in_place_index_t}} | + | {{cpp/title|in_place|in_place_type|in_place_index{{br}}|in_place_t|in_place_type_t|in_place_index_t}} |
{{cpp/utility/navbar}} | {{cpp/utility/navbar}} | ||
{{dcl begin}} | {{dcl begin}} | ||
| Line 31: | Line 31: | ||
@2,4,6@ The corresponding {{tt|std::in_place}}, {{tt|std::in_place_type}}, and {{tt|std::in_place_index}} instances of {{v|1,3,5}} are disambiguation tags that can be passed to the constructors of {{lc|std::expected}}, {{lc|std::optional}}, {{lc|std::variant}}, and {{lc|std::any}} to indicate that the contained object should be constructed in-place, and (for the latter two) the type of the object to be constructed. | @2,4,6@ The corresponding {{tt|std::in_place}}, {{tt|std::in_place_type}}, and {{tt|std::in_place_index}} instances of {{v|1,3,5}} are disambiguation tags that can be passed to the constructors of {{lc|std::expected}}, {{lc|std::optional}}, {{lc|std::variant}}, and {{lc|std::any}} to indicate that the contained object should be constructed in-place, and (for the latter two) the type of the object to be constructed. | ||
| − | === | + | ===Standard library=== |
| + | The following standard library vocabulary types use {{v|1-6}} as disambiguation tags: | ||
{{dsc begin}} | {{dsc begin}} | ||
{{dsc inc|cpp/utility/dsc expected}} | {{dsc inc|cpp/utility/dsc expected}} | ||
| Line 37: | Line 38: | ||
{{dsc inc|cpp/utility/dsc variant}} | {{dsc inc|cpp/utility/dsc variant}} | ||
{{dsc inc|cpp/utility/dsc any}} | {{dsc inc|cpp/utility/dsc any}} | ||
| + | {{dsc end}} | ||
| + | |||
| + | ===See also=== | ||
| + | {{dsc begin}} | ||
| + | {{dsc inc|cpp/container/dsc sorted_unique}} | ||
| + | {{dsc inc|cpp/container/dsc sorted_equivalent}} | ||
{{dsc end}} | {{dsc end}} | ||
{{langlinks|ja|ru|zh}} | {{langlinks|ja|ru|zh}} | ||
Revision as of 06:11, 20 March 2024
| Defined in header <utility>
|
||
| struct in_place_t { explicit in_place_t() = default; }; |
(1) | (since C++17) |
| inline constexpr std::in_place_t in_place {}; |
(2) | (since C++17) |
| template< class T > struct in_place_type_t { explicit in_place_type_t() = default; }; |
(3) | (since C++17) |
| template< class T > inline constexpr std::in_place_type_t<T> in_place_type {}; |
(4) | (since C++17) |
| template< std::size_t I > struct in_place_index_t { explicit in_place_index_t() = default; }; |
(5) | (since C++17) |
| template< std::size_t I > inline constexpr std::in_place_index_t<I> in_place_index {}; |
(6) | (since C++17) |
1,3,5) The type/type templates
std::in_place_t, std::in_place_type_t and std::in_place_index_t can be used in the constructor's parameter list to match the intended tag.2,4,6) The corresponding
std::in_place, std::in_place_type, and std::in_place_index instances of (1,3,5) are disambiguation tags that can be passed to the constructors of std::expected, std::optional, std::variant, and std::any to indicate that the contained object should be constructed in-place, and (for the latter two) the type of the object to be constructed.Standard library
The following standard library vocabulary types use (1-6) as disambiguation tags:
| (C++23) |
a wrapper that contains either an expected or error value (class template) |
| (C++17) |
a wrapper that may or may not hold an object (class template) |
| (C++17) |
a type-safe discriminated union (class template) |
| (C++17) |
objects that hold instances of any CopyConstructible type (class) |
See also
| (C++23) |
indicates that elements of a range are sorted and unique (tag) |
| indicates that elements of a range are sorted (uniqueness is not required) (tag) |
