Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / C++

std::nullptr_t — o tipo de nullptr

std::nullptr_t é o tipo distinto do literal nullptr, disponibilizado por <cstddef>. Não é um tipo de ponteiro: os seus valores podem produzir ponteiros nulos, e o próprio tipo permite que as sobrecargas de funções reconheçam nullptr.

Versão: C++23; repository compiler flag, production runtime not attested

Sintaxe

#include <cstddef>

std::nullptr_t value = nullptr;
// std::nullptr_t is the same type as decltype(nullptr).

std::nullptr_t é o tipo do literal nullptr. O cabeçalho <cstddef> disponibiliza este nome no espaço de nomes std; designa o mesmo tipo que decltype(nullptr). É importante distinguir o tipo std::nullptr_t, o literal nullptr e um ponteiro com valor nulo, como uma variável declarada como int* pointer = nullptr;.

std::nullptr_t não é um tipo de ponteiro nem um tipo de ponteiro para membro. Um valor deste tipo pode ser convertido implicitamente no valor nulo de um tipo de ponteiro ou de ponteiro para membro adequado. Esta conversão não cria um objeto para o qual se possa apontar; o ponteiro nulo resultante não deve ser desreferenciado.

O tipo distinto é importante na sobrecarga de funções. No exemplo, select(0) seleciona o parâmetro int, select(nullptr) seleciona std::nullptr_t e select(pointer) seleciona int*, apesar de pointer conter um valor nulo. A seleção depende do tipo do argumento e das regras de conversão, não apenas de um ponteiro ser nulo. Não trates NULL como outra forma de escrever nullptr: a definição dessa macro depende da implementação e pode ter um tipo inteiro.

Podes verificar o exemplo localmente em modo C++23. O código apresentado foi executado sem alterações num ambiente isolado e a saída padrão correspondeu exatamente à esperada. As fontes fornecidas são um rascunho de trabalho em evolução, não uma publicação definitiva de C++23. Uma opção do compilador não atesta o comportamento num ambiente de execução de produção.

Exemplos

#include <cstddef>
#include <iostream>

const char* select(int) { return "int"; }
const char* select(int*) { return "int*"; }
const char* select(std::nullptr_t) { return "nullptr_t"; }

int main() {
    std::nullptr_t empty = nullptr;
    int* pointer = empty;

    std::cout << select(0) << '\n';
    std::cout << select(nullptr) << '\n';
    std::cout << select(pointer) << '\n';
    std::cout << std::boolalpha << (pointer == nullptr) << '\n';
}

Resultado

int
nullptr_t
int*
true

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes