C++ 命名要求： NullablePointer （自 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

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 Formatters 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

此外，该类型的value-initialized对象必须生成该类型的空值。此空值应仅与其自身等效。该类型的默认初始化可能具有不确定的 或错误的（自 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	类型和值满足 BooleanTestable 要求 （直到 C++20） decltype(p != q) 模型 boolean-testable （自 C++20 起） 效果是 !(p == q)
p == np np == p	两个表达式的类型和值都满足 BooleanTestable 要求 （直到 C++20） decltype(p == np) 和 decltype(np == p) 各自模型 boolean-testable （自 C++20 起） 效果是 (p == Type())
p != np np != p	两个表达式的类型和值都满足 BooleanTestable 要求 （直到 C++20） decltype(p != np) 和 decltype(np != p) 各自模型 boolean-testable （自 C++20 起） 效果是 !(p == np)

注释

请注意，NullablePointer 类型不需要解引用 (operator* 或 operator->)。满足这些要求的最小类型是

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 的能力太弱，无法反映实现的预期	要求已加强