C++ 命名要求： CopyInsertable (自 C++11 起)

 

C++

编译器支持

独立和宿主式

语言

标准库

标准库头文件

命名要求

特性测试宏 (C++20)

语言支持库

概念库 (C++20)

诊断库

内存管理库

元编程库 (C++11)

通用工具库

容器库

迭代器库

范围库 (C++20)

算法库

字符串库

文本处理库

数值库

日期和时间库

输入/输出库

文件系统库 (C++17)

并发支持库 (C++11)

执行控制库 (C++26)

技术规范

符号索引

外部库

 

C++ 命名要求

基本 DefaultConstructible MoveConstructible (C++11) CopyConstructible CopyAssignable MoveAssignable (C++11) Destructible 类型属性 ScalarType PODType TriviallyCopyable (C++11) TrivialType (C++11) StandardLayoutType (C++11)   ImplicitLifetimeType 库范围 BooleanTestable EqualityComparable LessThanComparable Swappable ValueSwappable (C++11) NullablePointer (C++11) Hash (C++11) Allocator FunctionObject Callable Predicate BinaryPredicate Compare

容器 容器 ReversibleContainer AllocatorAwareContainer SequenceContainer ContiguousContainer (C++17) AssociativeContainer UnorderedAssociativeContainer (C++11)   容器元素 DefaultInsertable (C++11) CopyInsertable (C++11) MoveInsertable (C++11) EmplaceConstructible (C++11) Erasable (C++11) 迭代器 LegacyIterator LegacyInputIterator LegacyOutputIterator LegacyForwardIterator LegacyBidirectionalIterator LegacyRandomAccessIterator LegacyContiguousIterator (C++17) ConstexprIterator (C++20) 流 I/O FormattedInputFunction UnformattedInputFunction FormattedOutputFunction UnformattedOutputFunction 格式化器 BasicFormatter (C++20) Formatter (C++20)

随机数 SeedSequence (C++11) RandomNumberEngine (C++11) RandomNumberDistribution (C++11) UniformRandomBitGenerator (C++11) RandomNumberEngineAdaptor (C++11) 并发 BasicLockable (C++11) Lockable (C++11) TimedLockable (C++11) SharedLockable (C++14) SharedTimedLockable (C++14) Mutex (C++11) TimedMutex (C++11) SharedMutex (C++17) SharedTimedMutex (C++14) 范围 RangeAdaptorObject (C++20) RangeAdaptorClosureObject (C++20) 多维视图 LayoutMapping (C++23) LayoutMappingPolicy (C++23) AccessorPolicy (C++23) 其他 CharTraits RegexTraits (C++11)   BitmaskType LiteralType (C++11) NumericType UnaryTypeTrait (C++11) BinaryTypeTrait (C++11) TransformationTrait (C++11) 时钟 (C++11) TrivialClock (C++11)

 

指定此类型的对象可以通过给定的分配器进行就地复制构造。

要求

给定以下类型、值和表达式

类型	定义
T	一个对象类型
A	一个分配器类型
X	一个容器类型，满足以下所有条件 X::value_type 与 T 相同。 X::allocator_type 与 std::allocator_traits<A>::rebind_alloc<T> 相同。
值	定义
m	类型为 A 的左值
p	类型为 T* 的指针
表达式	定义
v	表示类型为 T / const T 的左值，或类型为 const T 的右值的表达式
expr	std::allocator_traits<A>::construct(m, p, v)

如果满足以下所有条件，则 T 是 CopyInsertable 到 X 中

• T 是 MoveInsertable 到 X 中。
• expr 是良构的。
• 评估 expr 不会更改 v 的值。
• 在评估 expr 之后，v 的值等价于 *p 的值。

注释

如果 A 是 std::allocator<T>，那么这将调用 placement new，如同 ::new((void*)p) T(v)(直到 C++20)std::construct_at(p, v)(自 C++20 起)。

虽然在 C++23 之前，当构造 std::basic_string 的元素时，需要使用自定义的 construct，但所有实现都只使用了默认机制。 P1072R10 修正了此要求，以符合现有的实践。

缺陷报告

以下行为变更的缺陷报告被追溯应用于先前发布的 C++ 标准。

DR	应用于	已发布行为	正确行为
LWG 2177	C++11	评估 expr 没有任何后置条件	已添加
LWG 3957	C++11	v 可以表示类型为 T 的右值	已排除