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

CKTIS / C++

std::ptrdiff_t — tipo de diferença entre apontadores

std::ptrdiff_t é um tipo inteiro com sinal definido pela implementação, disponibilizado por <cstddef>. É o tipo do resultado da subtração de apontadores: representa uma distância em elementos, não em bytes, e pode conter valores negativos.

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

Sintaxe

#include <cstddef>
std::ptrdiff_t distance = last - first;

std::ptrdiff_t, disponível após incluir <cstddef>, é um alias de um tipo inteiro com sinal escolhido pela implementação. Não assuma que é int ou long, nem que tem uma largura fixa. A subtração integrada de apontadores produz um resultado deste tipo.

Para apontadores para elementos da mesma matriz, last - first representa a diferença entre os respetivos índices, não uma quantidade de bytes. Pode usar-se um apontador imediatamente depois do fim da matriz, mas não o desreferencie. Inverter os operandos inverte o sinal do resultado.

Subtrair apontadores para matrizes distintas causa comportamento indefinido, mesmo que os respetivos endereços sejam próximos. Uma diferença que não possa ser representada por std::ptrdiff_t também causa comportamento indefinido. Guardar o resultado num tipo mais largo não corrige a própria subtração.

Em contrapartida, std::size_t não tem sinal e é utilizado, entre outras coisas, para os tamanhos dos objetos em bytes. Não o utilize para guardar uma diferença potencialmente negativa.

No exemplo, last aponta imediatamente após o fim da matriz de quatro elementos, pelo que last - first vale 4 e first - last vale -4. No ambiente testado, o programa escreve estes valores como números decimais. No entanto, numa implementação com um número suficiente de bits por byte, std::ptrdiff_t pode ser um alias de signed char. Nesse caso, inserir os valores diretamente em std::cout com << escreve caracteres em vez de números decimais.

Exemplos

#include <cstddef>
#include <iostream>

int main() {
    int values[] = {10, 20, 30, 40};
    const int* first = values;
    const int* last = values + 4;

    std::ptrdiff_t forward = last - first;
    std::ptrdiff_t backward = first - last;

    std::cout << forward << '\n' << backward << '\n';
}

Resultado

4
-4

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