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.