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

 

C++

编译器支持

独立和托管

语言

标准库

标准库头文件

命名要求

功能测试宏 (C++20)

语言支持库

概念库 (C++20)

元编程库 (C++11)

诊断库

通用实用工具库

字符串库

容器库

迭代器库

范围库 (C++20)

算法库

数值库

本地化库

输入/输出库

文件系统库 (C++17)

正则表达式库 (C++11)

并发支持库 (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

Container Container 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) Iterator 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) Clock (C++11) TrivialClock (C++11)

 

指定该类型为指针类对象，可以与 std::nullptr_t 对象进行比较。

要求

该类型必须满足以下所有要求

• EqualityComparable
• DefaultConstructible
• CopyConstructible
• CopyAssignable
• Swappable
• Destructible

此外，该类型的按值初始化对象必须生成该类型的空值。此空值应仅与其自身等效。该类型的默认初始化可能具有 不确定 或错误的(自 C++26 起) 值。

该类型的值必须 上下文可转换为 bool。此转换的效果是在值与空值等效时返回 false，否则返回 true。

此类型执行的任何操作都不得抛出异常。

该类型必须满足以下附加表达式，假设有两个类型值为 p 和 q，并且 np 是 std::nullptr_t 类型的值（可能经过 const 限定）

声明	效果
Type p(np); Type p = np;	之后，p 等效于 nullptr
表达式	效果
Type(np)	一个与 nullptr 等效的临时对象
p = np	必须返回一个 Type&，并且之后，p 等效于 nullptr
p != q	Type 和值满足 BooleanTestable 要求 (直到 C++20) decltype(p != q) 模型 布尔可测试 (自 C++20 起) 效果为 !(p == q)
p == np np == p	两个表达式的 Type 和值满足 BooleanTestable 要求 (直到 C++20) decltype(p == np) 和 decltype(np == p) 各自模型 布尔可测试 (自 C++20 起) 效果为 (p == Type())
p != np np != p	两个表达式的 Type 和值满足 BooleanTestable 要求 (直到 C++20) decltype(p != np) 和 decltype(np != p) 各自模型 布尔可测试 (自 C++20 起) 效果为 !(p == np)

注释

请注意，取消引用（operator* 或 operator->）不是 NullablePointer 类型的必需项。满足这些要求的最小类型是

class handle
{
    int id = 0;
public:
    handle() = default;
    handle(std::nullptr_t) {}
    explicit operator bool() const { return id != 0; }
    friend bool operator==(handle l, handle r) { return l.id == r.id; }
    friend bool operator!=(handle l, handle r) { return !(l == r); }
    // or only a defaulted operator== (since C++20)
};

标准库

以下类型满足 NullablePointer

• std::exception_ptr.

为了与标准库组件进行通信，以下类型必须满足 NullablePointer

• 每个 Allocator 类型 X 的成员类型 X::pointer、X::const_pointer、X::void_pointer 和 X::const_void_pointer。
• std::unique_ptr 的成员类型 pointer。

std::inout_ptr_t 和 std::out_ptr_t 的适配指针类型。

(自 C++23 起)

缺陷报告

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

DR	应用于	已发布的行为	正确行为
LWG 2114 (P2167R3)	C++11	与 bool 的上下文可转换性过弱，无法反映实现的预期	强化要求