std::nullptr_t

来自cppreference.com
< cpp‎ | types
 
 
工具库
通用工具
日期和时间
函数对象
格式化库 (C++20)
(C++11)
关系运算符 (C++20 中弃用)
整数比较函数
(C++20)(C++20)(C++20)
(C++20)
swap 与类型运算
(C++14)
(C++11)
(C++11)
(C++11)
(C++17)
常用词汇类型
(C++11)
(C++17)
(C++17)
(C++17)
(C++11)
(C++17)
(C++23)
初等字符串转换
(C++17)
(C++17)
 
类型支持
基本类型
定宽整数类型 (C++11)
定宽浮点类型 (C++23)
nullptr_t
(C++11)
数值极限
C 数值极限接口
运行时类型信息
 
在标头 <cstddef> 定义
using nullptr_t = decltype(nullptr);
(C++11 起)

std::nullptr_t 是空指针字面量 nullptr 的类型。它是既非指针类型亦非指向成员指针类型的独立类型。其值为空指针常量(见 NULL),并且可以隐式转换成任何指针或成员指针类型。

sizeof(std::nullptr_t) 等于 sizeof(void *).

注解

包含 <stddef.h>nullptr_t 在全局命名空间可用,即使它不是(C++11~C++20 所引用的) C99~C17 的一部分。

nullptr_t 自 C23 起亦为 C 的一部分。

示例

若二个重载接受不同指针类型,则需要 std::nullptr_t 的重载以接受空指针常量。

#include <cstddef>
#include <iostream>
 
void f(int*)
{
   std::cout << "Pointer to integer overload\n";
}
 
void f(double*)
{
   std::cout << "Pointer to double overload\n";
}
 
void f(std::nullptr_t)
{
   std::cout << "null pointer overload\n";
}
 
int main()
{
    int* pi {}; double* pd {};
 
    f(pi);
    f(pd);
    f(nullptr); // 无 void f(nullptr_t) 可能有歧义
    // f(0);    // 歧义调用:三个函数全部为候选
    // f(NULL); // 若 NULL 是整数空指针常量则为歧义
                // (如在大部分实现中的情况)
}

输出:

Pointer to integer overload
Pointer to double overload
null pointer overload

参阅

nullptr(C++11) 指定空指针值的指针字面量
实现定义的空指针常量
(宏常量)
检查类型是否为 std::nullptr_t
(类模板)